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

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

يتبع OpenClaw افتراضيا الوقت المحلي للمضيف للطوابع الزمنية للنقل والمنطقة الزمنية للمستخدم في موجّه النظام فقط. تُحفظ الطوابع الزمنية للمزوّد حتى تحتفظ الأدوات بدلالاتها الأصلية (الوقت الحالي متاح عبر 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

​
موجّه النظام: التاريخ والوقت الحاليان

إذا كانت المنطقة الزمنية للمستخدم معروفة، فإن موجّه النظام يتضمن قسما مخصصا للتاريخ والوقت الحاليين يتضمن المنطقة الزمنية فقط (بلا صيغة ساعة/وقت) للحفاظ على استقرار التخزين المؤقت للموجّه: 
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: ميلي ثوان منذ الحقبة (UTC)
  • timestampUtc: سلسلة ISO 8601 بتوقيت UTC
تُحفظ حقول المزوّد الخام حتى لا يُفقد أي شيء.
  • Slack: سلاسل شبيهة بالحقبة من واجهة API
  • Discord: طوابع زمنية ISO بتوقيت UTC
  • Telegram/WhatsApp: طوابع زمنية رقمية/ISO خاصة بالمزوّد
إذا كنت تحتاج إلى الوقت المحلي، فحوّله لاحقا باستخدام المنطقة الزمنية المعروفة.

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