---
read_when:
    - أنت تغيّر كيفية عرض الطوابع الزمنية للنموذج أو للمستخدمين
    - أنت تستكشف أخطاء تنسيق الوقت في الرسائل أو مخرجات system prompt وإصلاحها
summary: التعامل مع التاريخ والوقت عبر الأظرف، وprompts، والأدوات، والموصلات
title: التاريخ والوقت
x-i18n:
    generated_at: "2026-04-05T12:41:54Z"
    model: gpt-5.4
    provider: openai
    source_hash: 753af5946a006215d6af2467fa478f3abb42b1dff027cf85d5dc4c7ba4b58d39
    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: التاريخ والوقت الحاليان

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

```
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` **المنطقة الزمنية المحلية للمستخدم** لسياق prompt.
- يتحكم `timeFormat` في عرض **12 ساعة/24 ساعة** في prompt. وتتبع `auto` تفضيلات نظام التشغيل.

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

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

## حمولات الأدوات + الموصلات (وقت الموفّر الخام + الحقول المطبّعة)

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

- `timestampMs`: ميلي ثانية منذ epoch ‏(UTC)
- `timestampUtc`: سلسلة UTC بتنسيق ISO 8601

يتم الاحتفاظ بالحقول الخام الخاصة بالموفّر حتى لا يضيع شيء.

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

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

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

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