---
read_when:
    - تريد نموذجًا ذهنيًا سريعًا للتعامل مع المناطق الزمنية
    - أنت تحدد أين تعيّن منطقة زمنية أو تتجاوزها
summary: أين تظهر المناطق الزمنية في OpenClaw — المغلفات، وحمولات الأدوات، وموجه النظام
title: المناطق الزمنية
x-i18n:
    generated_at: "2026-06-27T17:33:36Z"
    model: gpt-5.5
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: cc5bfe595c81b9c6ffaceac4c86b6f82b82917a506cdd7227e3e8cb1c0eb99a3
    source_path: concepts/timezone.md
    workflow: 16
---

يوحّد OpenClaw الطوابع الزمنية بحيث يرى النموذج **وقتًا مرجعيًا واحدًا** بدلًا من مزيج من ساعات محلية لمزوّدين مختلفين. توجد ثلاثة أسطح تظهر فيها المناطق الزمنية، ولكل منها غرضه الخاص:

## ثلاثة أسطح للمناطق الزمنية

| السطح             | ما يعرضه                                                                                                 | الافتراضي                              | يُضبط عبر                                                |
| ----------------- | --------------------------------------------------------------------------------------------------------- | -------------------------------------- | -------------------------------------------------------- |
| أغلفة الرسائل     | تلف الرسائل الواردة من القناة: `[Signal +1555 Sun 2026-01-18 00:19:42 PST] hello`                        | محلي للمضيف                            | `agents.defaults.envelopeTimezone`                       |
| حمولات الأدوات    | أدوات القناة بنمط `readMessages` ترجع وقت المزوّد الخام + `timestampMs` / `timestampUtc` الموحّد          | حقول UTC موجودة دائمًا                 | غير قابل للضبط — يحافظ على الطوابع الزمنية الأصلية للمزوّد |
| موجه النظام       | كتلة صغيرة باسم `Current Date & Time` تحتوي على **المنطقة الزمنية فقط** (بلا قيمة ساعة، لاستقرار التخزين المؤقت) | المنطقة الزمنية للمضيف إذا لم تُضبط `userTimezone` | `agents.defaults.userTimezone`                           |

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

## ضبط المنطقة الزمنية للمستخدم

```json5
{
  agents: {
    defaults: {
      userTimezone: "America/Chicago",
    },
  },
}
```

إذا لم تُضبط `userTimezone`، يحل OpenClaw المنطقة الزمنية للمضيف في وقت التشغيل (من دون كتابة ضبط). يتحكم `agents.defaults.timeFormat` (`auto` | `12` | `24`) في عرض 12 ساعة/24 ساعة داخل الأغلفة والأسطح اللاحقة، وليس في قسم موجه النظام.

## متى تتجاوز الإعداد

- **استخدم أغلفة UTC** (`envelopeTimezone: "utc"`) عندما تريد طوابع زمنية مستقرة عبر مضيفين في مناطق مختلفة، أو عندما تريد أن تتطابق السجلات المتوافقة مع UTC مع مخرجات التشخيص.
- **استخدم منطقة IANA ثابتة** (مثل `"Europe/Vienna"`) عندما يكون مضيف Gateway في منطقة زمنية والمستخدم في منطقة أخرى، وتريد أن تُقرأ الأغلفة وفق منطقة المستخدم بغض النظر عن انتقال المضيف.
- **اضبط `envelopeTimestamp: "off"`** عندما لا يكون سياق الطابع الزمني مفيدًا للمحادثة. يزيل هذا الطوابع الزمنية المطلقة من الأغلفة، وبادئات موجه الوكيل المباشرة، وبادئات إدخال النموذج المضمنة.

للمرجع الكامل للسلوك، وأمثلة لكل مزوّد، وتنسيق الوقت المنقضي، راجع [التاريخ والوقت](/ar/date-time).

## ذو صلة

- [التاريخ والوقت](/ar/date-time) — السلوك الكامل للأغلفة/الأدوات/الموجه وأمثلة.
- [Heartbeat](/ar/gateway/heartbeat) — تستخدم الساعات النشطة المنطقة الزمنية للجدولة.
- [مهام Cron](/ar/automation/cron-jobs) — تستخدم تعبيرات Cron المنطقة الزمنية للجدولة.