Concept internals
مناطق زمانی
OpenClaw مُهرهای زمانی را استاندارد میکند تا مدل بهجای ترکیبی از ساعتهای محلیِ ارائهدهندهها، یک زمان مرجع واحد ببیند. سه سطح وجود دارد که منطقههای زمانی در آنها ظاهر میشوند و هرکدام هدف خود را دارند:
سه سطح منطقه زمانی
| سطح | آنچه نشان میدهد | پیشفرض | پیکربندی از طریق |
|---|---|---|---|
| پوششهای پیام | پیامهای ورودی کانال را میپوشاند: [Signal +1555 Sun 2026-01-18 00:19:42 PST] hello |
محلیِ میزبان | agents.defaults.envelopeTimezone |
| بارهای ابزار | ابزارهای شبیه readMessages کانال، زمان خام ارائهدهنده + timestampMs / timestampUtc نرمالشده را برمیگردانند |
فیلدهای UTC همیشه وجود دارند | قابل پیکربندی نیست — مُهرهای زمانی بومیِ ارائهدهنده را حفظ میکند |
| پرامپت سیستم | یک بلوک کوچک Current Date & Time با فقط منطقه زمانی (بدون مقدار ساعت، برای پایداری کش) |
منطقه زمانی میزبان اگر userTimezone تنظیم نشده باشد |
agents.defaults.userTimezone |
پرامپت سیستم عمداً ساعت زنده را حذف میکند تا کش پرامپت در طول نوبتها پایدار بماند. وقتی عامل به زمان فعلی نیاز دارد، session_status را فراخوانی میکند.
تنظیم منطقه زمانی کاربر
{ agents: { defaults: { userTimezone: "America/Chicago", }, },}اگر userTimezone تنظیم نشده باشد، OpenClaw منطقه زمانی میزبان را در زمان اجرا تشخیص میدهد (بدون نوشتن پیکربندی). agents.defaults.timeFormat (auto | 12 | 24) نمایش ۱۲ ساعته/۲۴ ساعته را در پوششها و سطحهای پاییندستی کنترل میکند، نه در بخش پرامپت سیستم.
زمان override کردن
- از پوششهای UTC استفاده کنید (
envelopeTimezone: "utc") وقتی میخواهید مُهرهای زمانی در میزبانهای مناطق مختلف پایدار باشند، یا وقتی میخواهید گزارشهای همتراز با UTC با خروجی عیبیابی مطابقت داشته باشند. - از یک منطقه IANA ثابت استفاده کنید (مثلاً
"Europe/Vienna") وقتی میزبان Gateway در یک منطقه است اما کاربر در منطقهای دیگر قرار دارد و میخواهید پوششها صرفنظر از مهاجرت میزبان، در منطقه کاربر خوانده شوند. envelopeTimestamp: "off"را تنظیم کنید وقتی زمینه مُهر زمانی برای مکالمه مفید نیست. این کار مُهرهای زمانی مطلق را از پوششها، پیشوندهای مستقیم پرامپت عامل، و پیشوندهای جاسازیشده ورودی مدل حذف میکند.
برای مرجع کامل رفتار، نمونهها بهازای هر ارائهدهنده، و قالببندی زمان سپریشده، تاریخ و زمان را ببینید.
مرتبط
- تاریخ و زمان — رفتار و نمونههای کامل پوشش/ابزار/پرامپت.
- Heartbeat — ساعات فعال از منطقه زمانی برای زمانبندی استفاده میکنند.
- کارهای Cron — عبارتهای cron از منطقه زمانی برای زمانبندی استفاده میکنند.
Was this useful?
