الانتقال إلى المحتوى الرئيسي

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

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

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

تُغلّف الرسائل الواردة بطابع زمني (بدقة الدقائق): 
[Provider ... 2026-01-05 16:26 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 2026-01-18 00:19 PST] hello
المنطقة الزمنية للمستخدم: 
[WhatsApp +1555 2026-01-18 00:19 CST] hello
مع تمكين الزمن المنقضي: 
[WhatsApp +1555 +30s 2026-01-18T05:19Z] follow-up

​
system prompt: التاريخ والوقت الحاليان

إذا كانت المنطقة الزمنية للمستخدم معروفة، فإن system prompt تتضمن قسمًا مخصصًا باسم Current Date & Time يحتوي على المنطقة الزمنية فقط (من دون ساعة/تنسيق وقت) للحفاظ على استقرار تخزين prompt المؤقت: 
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 المنطقة الزمنية المحلية للمستخدم لسياق prompt.
  • يتحكم timeFormat في عرض 12 ساعة/24 ساعة في prompt. وتتبع auto تفضيلات نظام التشغيل.

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

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

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

تعيد أدوات القنوات طوابع زمنية أصلية خاصة بالموفّر وتضيف حقولًا مطبّعة لتحقيق الاتساق:
  • timestampMs: ميلي ثانية منذ epoch ‏(UTC)
  • timestampUtc: سلسلة UTC بتنسيق ISO 8601
يتم الاحتفاظ بالحقول الخام الخاصة بالموفّر حتى لا يضيع شيء.
  • Slack: سلاسل شبيهة بـ epoch من API
  • Discord: طوابع زمنية UTC بصيغة ISO
  • Telegram/WhatsApp: طوابع زمنية رقمية/ISO خاصة بالموفّر
إذا كنت بحاجة إلى الوقت المحلي، فحوّله في المرحلة اللاحقة باستخدام المنطقة الزمنية المعروفة.

​
وثائق ذات صلة