> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

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

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

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

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

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

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

يمكنك تجاوز هذا السلوك:

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  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.
```

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

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  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 خاصة بالمزوّد

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

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

* [مطالبة النظام](/ar/concepts/system-prompt)
* [المناطق الزمنية](/ar/concepts/timezone)
* [الرسائل](/ar/concepts/messages)