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) في عرض 12 ساعة/24 ساعة داخل الأغلفة والأسطح اللاحقة، وليس في قسم موجه النظام.
متى تتجاوز الإعداد
- استخدم أغلفة UTC (
envelopeTimezone: "utc") عندما تريد طوابع زمنية مستقرة عبر مضيفين في مناطق مختلفة، أو عندما تريد أن تتطابق السجلات المتوافقة مع UTC مع مخرجات التشخيص. - استخدم منطقة IANA ثابتة (مثل
"Europe/Vienna") عندما يكون مضيف Gateway في منطقة زمنية والمستخدم في منطقة أخرى، وتريد أن تُقرأ الأغلفة وفق منطقة المستخدم بغض النظر عن انتقال المضيف. - اضبط
envelopeTimestamp: "off"عندما لا يكون سياق الطابع الزمني مفيدًا للمحادثة. يزيل هذا الطوابع الزمنية المطلقة من الأغلفة، وبادئات موجه الوكيل المباشرة، وبادئات إدخال النموذج المضمنة.
للمرجع الكامل للسلوك، وأمثلة لكل مزوّد، وتنسيق الوقت المنقضي، راجع التاريخ والوقت.
ذو صلة
- التاريخ والوقت — السلوك الكامل للأغلفة/الأدوات/الموجه وأمثلة.
- Heartbeat — تستخدم الساعات النشطة المنطقة الزمنية للجدولة.
- مهام Cron — تستخدم تعبيرات Cron المنطقة الزمنية للجدولة.
Was this useful?