---
read_when:
    - تريد نموذجًا ذهنيًا سريعًا للتعامل مع المناطق الزمنية
    - أنت تقرر أين تعيّن منطقة زمنية أو تتجاوزها
summary: أين تظهر المناطق الزمنية في OpenClaw — المغلفات، وحمولات الأدوات، وموجه النظام
title: المناطق الزمنية
x-i18n:
    generated_at: "2026-05-06T07:51:26Z"
    model: gpt-5.5
    provider: openai
    source_hash: 041b207a0fa2758a20e8f3c4eca852d3dd416560d045459cb4d86709b45449e3
    source_path: concepts/timezone.md
    workflow: 16
---

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

## ثلاثة مواضع للمناطق الزمنية

| الموضع           | ما يعرضه                                                                                           | الافتراضي                               | يُضبط عبر                                          |
| ----------------- | ------------------------------------------------------------------------------------------------------- | ------------------------------------- | ------------------------------------------------------- |
| أغلفة الرسائل | تغلّف رسائل القنوات الواردة: `[Signal +1555 2026-01-18 00:19 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 المنطقة الزمنية للجدولة.