---
read_when:
    - أنت تغيّر كيفية عرض الطوابع الزمنية للنموذج أو للمستخدمين
    - أنت تستكشف أخطاء تنسيق الوقت في الرسائل أو في مخرجات موجّه النظام
summary: معالجة التاريخ والوقت عبر المغلفات والمطالبات والأدوات والموصلات
title: التاريخ والوقت
x-i18n:
    generated_at: "2026-05-06T07:52:11Z"
    model: gpt-5.5
    provider: openai
    source_hash: 5f695a5009c949cc24689bfb8950d96cf72f0b2a1472efe88923182527b56b74
    source_path: date-time.md
    workflow: 16
---

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

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

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

```
[Provider ... 2026-01-05 16:26 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 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.
```

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

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

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

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

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