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

المفاهيم الداخلية

المناطق الزمنية

يقوم 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). راجع التاريخ والوقت للاطلاع على السلوك الكامل والأمثلة.

تتبع الاستخدامالاعتمادات