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

​
ثلاثة أسطح للمناطق الزمنية

السطحما يعرضهالافتراضييُضبط عبر
أغلفة الرسائلتلف الرسائل الواردة من القناة: [Signal +1555 Sun 2026-01-18 00:19:42 PST] helloمحلي للمضيفagents.defaults.envelopeTimezone
حمولات الأدواتأدوات القناة بنمط readMessages ترجع وقت المزوّد الخام + timestampMs / timestampUtc الموحّدحقول UTC موجودة دائمًاغير قابل للضبط — يحافظ على الطوابع الزمنية الأصلية للمزوّد
موجه النظامكتلة صغيرة باسم Current Date & Time تحتوي على المنطقة الزمنية فقط (بلا قيمة ساعة، لاستقرار التخزين المؤقت)المنطقة الزمنية للمضيف إذا لم تُضبط userTimezoneagents.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 المنطقة الزمنية للجدولة.