مرجع تقني

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

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

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

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

[Provider ... 2026-01-05 16:26 PST] نص الرسالة

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

{
  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] مرحبًا

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

[WhatsApp +1555 2026-01-18 00:19 CST] مرحبًا

تمكين الوقت المنقضي:

[WhatsApp +1555 +30s 2026-01-18T05:19Z] متابعة

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

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

Time zone: America/Chicago

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

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

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

System: [2026-01-12 12:19:17 PST] تم تبديل النموذج.

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

{
  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 خاصة بالمزود

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

وثائق ذات صلة

نظافة النصTypeBox