مناطق زمانی

OpenClaw مُهرهای زمانی را استاندارد می‌کند تا مدل به‌جای ترکیبی از ساعت‌های محلیِ ارائه‌دهنده‌ها، یک زمان مرجع واحد ببیند. سه سطح وجود دارد که مناطق زمانی در آن‌ها ظاهر می‌شوند و هرکدام هدف خود را دارند:

# سه سطح منطقه زمانی

سطح	آنچه نشان می‌دهد	پیش‌فرض	پیکربندی از طریق
پوشش‌های پیام	پیام‌های ورودی کانال را دربر می‌گیرد: [Signal +1555 2026-01-18 00:19 PST] hello	محلیِ میزبان	agents.defaults.envelopeTimezone
بارهای ابزار	ابزارهای سبکِ readMessages کانال، زمان خام ارائه‌دهنده + timestampMs / timestampUtc نرمال‌شده را برمی‌گردانند	فیلدهای UTC همیشه وجود دارند	قابل پیکربندی نیست — مُهرهای زمانی بومیِ ارائه‌دهنده را حفظ می‌کند
پرامپت سیستمی	یک بلوک کوچک Current Date & Time با فقط منطقه زمانی (بدون مقدار ساعت، برای پایداری کش)	اگر userTimezone تنظیم نشده باشد، منطقه زمانی میزبان	agents.defaults.userTimezone

پرامپت سیستمی عمداً ساعت زنده را حذف می‌کند تا کش‌کردن پرامپت در نوبت‌های مختلف پایدار بماند. وقتی agent به زمان فعلی نیاز داشته باشد، session_status را فراخوانی می‌کند.

# تنظیم منطقه زمانی کاربر

{
  agents: {
    defaults: {
      userTimezone: "America/Chicago",
    },
  },
}

اگر userTimezone تنظیم نشده باشد، OpenClaw منطقه زمانی میزبان را در زمان اجرا تشخیص می‌دهد (بدون نوشتن پیکربندی). agents.defaults.timeFormat (auto | 12 | 24) نمایش ۱۲/۲۴ ساعته را در پوشش‌ها و سطح‌های پایین‌دستی کنترل می‌کند، نه در بخش پرامپت سیستمی.

# زمان مناسب برای بازنویسی

• از پوشش‌های UTC استفاده کنید (envelopeTimezone: "utc") وقتی می‌خواهید مُهرهای زمانی در میزبان‌های مناطق مختلف پایدار باشند، یا وقتی می‌خواهید لاگ‌های هم‌راستا با UTC با خروجی عیب‌یابی منطبق باشند.
• از یک منطقه ثابت IANA استفاده کنید (مثلاً "Europe/Vienna") وقتی میزبان Gateway در یک منطقه است اما کاربر در منطقه‌ای دیگر قرار دارد و می‌خواهید پوشش‌ها، فارغ از جابه‌جایی میزبان، در منطقه کاربر خوانده شوند.
• برای پوشش‌های کم‌توکن، envelopeTimestamp: "off" را تنظیم کنید وقتی زمینه مُهر زمانی برای گفتگو مفید نیست.

برای مرجع کامل رفتار، نمونه‌ها برای هر ارائه‌دهنده، و قالب‌بندی زمان سپری‌شده، تاریخ و زمان را ببینید.

# مرتبط

• تاریخ و زمان — رفتار و نمونه‌های کامل پوشش/ابزار/پرامپت.
• Heartbeat — ساعت‌های فعال از منطقه زمانی برای زمان‌بندی استفاده می‌کنند.
• کارهای Cron — عبارت‌های cron از منطقه زمانی برای زمان‌بندی استفاده می‌کنند.