---
read_when:
    - أنت تغيّر طريقة عرض الطوابع الزمنية للنموذج أو للمستخدمين
    - أنت تصحح تنسيق الوقت في الرسائل أو مخرجات مطالبة النظام
summary: معالجة التاريخ والوقت عبر المغلفات والمطالبات والأدوات والموصلات
title: التاريخ والوقت
x-i18n:
    generated_at: "2026-06-27T17:34:19Z"
    model: gpt-5.5
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: d40e8626269d26a14506a178080b353529080b6ee5ce523c3281521f1a34bf90
    source_path: date-time.md
    workflow: 16
---

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

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

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

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

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

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

```json5
{
  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
{
  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)