---
read_when:
    - أنت تغيّر كيفية عرض الطوابع الزمنية للنموذج أو للمستخدمين
    - أنت تصحح تنسيق الوقت في الرسائل أو في مخرجات system prompt
summary: التعامل مع التاريخ والوقت عبر الأغلفة والمطالبات والأدوات والموصلات
title: التاريخ والوقت
x-i18n:
    generated_at: "2026-04-24T07:39:45Z"
    model: gpt-5.4
    provider: openai
    source_hash: c3d54da4077ac985ae1209b4364e049afb83b5746276e164181c1a30f0faa06e
    source_path: date-time.md
    workflow: 15
---

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

يفترض OpenClaw افتراضيًا **الوقت المحلي للمضيف للطوابع الزمنية الخاصة بالنقل** و**المنطقة الزمنية للمستخدم فقط في system prompt**.
ويتم الحفاظ على الطوابع الزمنية الخاصة بالمزوّد حتى تحتفظ الأدوات بدلالاتها الأصلية (الوقت الحالي متاح عبر `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
```

## system prompt: Current Date & Time

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

```
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` تفضيلات نظام التشغيل.

## اكتشاف تنسيق الوقت (auto)

عندما تكون `timeFormat: "auto"`، يفحص OpenClaw تفضيلات نظام التشغيل (macOS/Windows)
ويعود إلى تنسيق اللغة المحلية عند الحاجة. وتكون القيمة المكتشفة **مخزنة مؤقتًا لكل عملية**
لتجنب استدعاءات النظام المتكررة.

## حمولات الأدوات + الموصلات (وقت المزوّد الخام + حقول موحّدة)

تعيد أدوات القنوات **طوابع زمنية أصلية خاصة بالمزوّد** وتضيف حقولًا موحّدة لتحقيق الاتساق:

- `timestampMs`: مللي ثواني الحقبة (UTC)
- `timestampUtc`: سلسلة UTC بصيغة ISO 8601

يتم الحفاظ على حقول المزوّد الخام حتى لا يُفقد أي شيء.

- Slack: سلاسل شبيهة بالحقبة من API
- Discord: طوابع زمنية UTC بصيغة ISO
- Telegram/WhatsApp: طوابع زمنية رقمية/ISO خاصة بالمزوّد

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

## وثائق ذات صلة

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