المناطق الزمنية

OpenClaw يوحّد الطوابع الزمنية بحيث يرى النموذج وقتًا مرجعيًا واحدًا بدلًا من مزيج من الساعات المحلية لمزوّدي الخدمة. توجد ثلاثة مواضع تظهر فيها المناطق الزمنية، ولكل منها غرضه الخاص:

# ثلاثة مواضع للمناطق الزمنية

الموضع	ما يعرضه	الافتراضي	يُضبط عبر
أغلفة الرسائل	تغلّف رسائل القنوات الواردة: [Signal +1555 2026-01-18 00:19 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) في عرض 12 ساعة/24 ساعة في الأغلفة والمواضع اللاحقة، وليس في قسم موجه النظام.

# متى تستخدم التجاوز

• استخدم أغلفة UTC (envelopeTimezone: "utc") عندما تريد طوابع زمنية مستقرة عبر مضيفين في مناطق مختلفة، أو عندما تريد سجلات متوافقة مع UTC لتطابق مخرجات التشخيص.
• استخدم منطقة IANA ثابتة (مثل "Europe/Vienna") عندما يكون مضيف Gateway في منطقة والمستخدم في منطقة أخرى وتريد أن تُقرأ الأغلفة بمنطقة المستخدم بغض النظر عن ترحيل المضيف.
• اضبط envelopeTimestamp: "off" للأغلفة منخفضة الرموز عندما لا يكون سياق الطابع الزمني مفيدًا للمحادثة.

للاطلاع على مرجع السلوك الكامل، والأمثلة لكل مزوّد، وتنسيق الوقت المنقضي، راجع التاريخ والوقت.

# ذات صلة

• التاريخ والوقت — السلوك الكامل للأغلفة/الأدوات/الموجهات مع أمثلة.
• Heartbeat — تستخدم الساعات النشطة المنطقة الزمنية للجدولة.
• مهام Cron — تستخدم تعبيرات Cron المنطقة الزمنية للجدولة.