المناطق الزمنية
يقوم OpenClaw بتوحيد الطوابع الزمنية بحيث يرى النموذج وقت مرجعي واحدًا.
مغلفات الرسائل (محلي افتراضيًا)
يتم تغليف الرسائل الواردة في مغلف مثل:
[Provider ... 2026-01-05 16:26 PST] نص الرسالة
الطابع الزمني في المغلف هو محلي بالنسبة للمضيف افتراضيًا، بدقة الدقائق. يمكنك تجاوز هذا باستخدام:
{
agents: {
defaults: {
envelopeTimezone: "local", // "utc" | "local" | "user" | منطقة IANA الزمنية
envelopeTimestamp: "on", // "on" | "off"
envelopeElapsed: "on", // "on" | "off"
},
},
}
envelopeTimezone: "utc"يستخدم التوقيت العالمي المنسق (UTC).envelopeTimezone: "user"يستخدمagents.defaults.userTimezone(يتراجع إلى المنطقة الزمنية للمضيف).- استخدم منطقة زمنية صريحة من IANA (مثل
"Europe/Vienna") لإزاحة زمنية ثابتة. envelopeTimestamp: "off"يزيل الطوابع الزمنية المطلقة من رؤوس المغلفات.envelopeElapsed: "off"يزيل لاحقات الوقت المنقضي (نمط+2m).
أمثلة
محلي (افتراضي):
[Signal Alice +1555 2026-01-18 00:19 PST] مرحبًا
منطقة زمنية ثابتة:
[Signal Alice +1555 2026-01-18 06:19 GMT+1] مرحبًا
الوقت المنقضي:
[Signal Alice +1555 +2m 2026-01-18T05:19Z] متابعة
حمولات الأدوات (بيانات المزود الخام + حقول موحدة)
تُرجع استدعاءات الأدوات (channels.discord.readMessages, channels.slack.readMessages, إلخ) طوابع المزود الزمنية الخام. كما نرفق حقولًا موحدة للاتساق:
timestampMs(مللي ثانية من عصر UTC)timestampUtc(سلسلة ISO 8601 بالتوقيت العالمي المنسق UTC)
يتم الحفاظ على حقول المزود الخام.
المنطقة الزمنية للمستخدم للمطالبة النظامية
عيّن agents.defaults.userTimezone لإخبار النموذج بالمنطقة الزمنية المحلية للمستخدم. إذا لم يتم تعيينها، يحل OpenClaw المنطقة الزمنية للمضيف أثناء وقت التشغيل (بدون كتابة في التكوين).
{
agents: { defaults: { userTimezone: "America/Chicago" } },
}
تتضمن المطالبة النظامية:
- قسم
التاريخ والوقت الحاليمع الوقت المحلي والمنطقة الزمنية تنسيق الوقت: 12 ساعةأو24 ساعة
يمكنك التحكم في تنسيق المطالبة باستخدام agents.defaults.timeFormat (auto | 12 | 24). راجع التاريخ والوقت للاطلاع على السلوك الكامل والأمثلة.