التاريخ والوقت

يعتمد OpenClaw افتراضيًا على الوقت المحلي للمضيف للطوابع الزمنية للنقل والمنطقة الزمنية للمستخدم داخل مطالبة النظام فقط. تُحفَظ طوابع المزوّد الزمنية حتى تحتفظ الأدوات بدلالاتها الأصلية (يتوفر الوقت الحالي عبر session_status).

مغلفات الرسائل (محلية افتراضيًا)

تُغلَّف الرسائل الواردة بطابع زمني (بدقة الثانية):

[Provider ... Mon 2026-01-05 16:26:34 PST] message text

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

{
  agents: {
    defaults: {
      envelopeTimezone: "local", // "utc" | "local" | "user" | IANA timezone
      envelopeTimestamp: "on", // "on" | "off"
      envelopeElapsed: "on", // "on" | "off"
    },
  },
}

يستخدم envelopeTimezone: "utc" توقيت UTC.
يستخدم envelopeTimezone: "local" المنطقة الزمنية للمضيف.
يستخدم envelopeTimezone: "user" قيمة agents.defaults.userTimezone (مع الرجوع إلى المنطقة الزمنية للمضيف).
استخدم منطقة زمنية صريحة من IANA (مثل "America/Chicago") لمنطقة ثابتة.
يزيل envelopeTimestamp: "off" الطوابع الزمنية المطلقة من رؤوس المغلفات، وبادئات مطالبة الوكيل المباشرة، وبادئات إدخال النموذج المضمّنة.
يزيل envelopeElapsed: "off" لواحق الوقت المنقضي (نمط +2m).

أمثلة

محلي (افتراضي):

[WhatsApp +1555 Sun 2026-01-18 00:19:42 PST] hello

المنطقة الزمنية للمستخدم:

[WhatsApp +1555 Sun 2026-01-18 00:19:42 CST] hello

الوقت المنقضي مفعّل:

[WhatsApp +1555 +30s Sun 2026-01-18T05:19:00Z] follow-up

مطالبة النظام: التاريخ والوقت الحاليان

إذا كانت المنطقة الزمنية للمستخدم معروفة، تتضمن مطالبة النظام قسمًا مخصصًا التاريخ والوقت الحاليان مع المنطقة الزمنية فقط (بدون تنسيق للساعة/الوقت) للحفاظ على استقرار تخزين المطالبة مؤقتًا:

Time zone: America/Chicago

عندما يحتاج الوكيل إلى الوقت الحالي، استخدم أداة session_status؛ إذ تتضمن بطاقة الحالة سطر طابع زمني.

أسطر أحداث النظام (محلية افتراضيًا)

تسبق أحداث النظام الموضوعة في قائمة الانتظار والمدرجة في سياق الوكيل بطابع زمني يستخدم اختيار المنطقة الزمنية نفسه المستخدم في مغلفات الرسائل (افتراضيًا: محلي للمضيف).

System: [2026-01-12 12:19:17 PST] Model switched.

تكوين المنطقة الزمنية للمستخدم + التنسيق

{
  agents: {
    defaults: {
      userTimezone: "America/Chicago",
      timeFormat: "auto", // auto | 12 | 24
    },
  },
}

يضبط userTimezone المنطقة الزمنية المحلية للمستخدم لسياق المطالبة.
يتحكم timeFormat في عرض 12/24 ساعة في المطالبة. يتبع auto تفضيلات نظام التشغيل.

اكتشاف تنسيق الوقت (تلقائي)

عند استخدام timeFormat: "auto"، يفحص OpenClaw تفضيل نظام التشغيل (macOS/Windows) ويرجع إلى تنسيق اللغة المحلية عند الحاجة. تُخزَّن القيمة المكتشفة مؤقتًا لكل عملية لتجنب تكرار استدعاءات النظام.

حمولات الأدوات + الموصلات (وقت المزوّد الخام + حقول مطبّعة)

تعيد أدوات القنوات طوابع زمنية أصلية للمزوّد وتضيف حقولًا مطبّعة للاتساق:

timestampMs: عدد المللي ثواني منذ epoch (UTC)
timestampUtc: سلسلة UTC بصيغة ISO 8601

تُحفَظ حقول المزوّد الخام حتى لا يُفقد أي شيء.

Slack: سلاسل شبيهة بـ epoch من API
Discord: طوابع زمنية UTC بصيغة ISO
Telegram/WhatsApp: طوابع زمنية رقمية/ISO خاصة بالمزوّد

إذا احتجت إلى الوقت المحلي، فحوّله لاحقًا باستخدام المنطقة الزمنية المعروفة.

​مغلفات الرسائل (محلية افتراضيًا)

​أمثلة

​مطالبة النظام: التاريخ والوقت الحاليان

​أسطر أحداث النظام (محلية افتراضيًا)

​تكوين المنطقة الزمنية للمستخدم + التنسيق

​اكتشاف تنسيق الوقت (تلقائي)

​حمولات الأدوات + الموصلات (وقت المزوّد الخام + حقول مطبّعة)

​مستندات ذات صلة