---
read_when:
    - برای مدیریت منطقه‌های زمانی، یک مدل ذهنی سریع می‌خواهید
    - در حال تصمیم‌گیری هستید که کجا یک منطقه زمانی را تنظیم یا بازنویسی کنید
summary: جاهایی که مناطق زمانی در OpenClaw ظاهر می‌شوند — پوشانه‌ها، بارداده‌های ابزار، پرامپت سیستم
title: مناطق زمانی
x-i18n:
    generated_at: "2026-05-06T09:14:40Z"
    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`                          |

پرامپت سیستمی عمداً ساعت زنده را حذف می‌کند تا کش‌کردن پرامپت در نوبت‌های مختلف پایدار بماند. وقتی agent به زمان فعلی نیاز داشته باشد، `session_status` را فراخوانی می‌کند.

## تنظیم منطقه زمانی کاربر

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

اگر `userTimezone` تنظیم نشده باشد، OpenClaw منطقه زمانی میزبان را در زمان اجرا تشخیص می‌دهد (بدون نوشتن پیکربندی). `agents.defaults.timeFormat` (`auto` | `12` | `24`) نمایش ۱۲/۲۴ ساعته را در پوشش‌ها و سطح‌های پایین‌دستی کنترل می‌کند، نه در بخش پرامپت سیستمی.

## زمان مناسب برای بازنویسی

- **از پوشش‌های UTC استفاده کنید** (`envelopeTimezone: "utc"`) وقتی می‌خواهید مُهرهای زمانی در میزبان‌های مناطق مختلف پایدار باشند، یا وقتی می‌خواهید لاگ‌های هم‌راستا با UTC با خروجی عیب‌یابی منطبق باشند.
- **از یک منطقه ثابت IANA استفاده کنید** (مثلاً `"Europe/Vienna"`) وقتی میزبان Gateway در یک منطقه است اما کاربر در منطقه‌ای دیگر قرار دارد و می‌خواهید پوشش‌ها، فارغ از جابه‌جایی میزبان، در منطقه کاربر خوانده شوند.
- **برای پوشش‌های کم‌توکن، `envelopeTimestamp: "off"` را تنظیم کنید** وقتی زمینه مُهر زمانی برای گفتگو مفید نیست.

برای مرجع کامل رفتار، نمونه‌ها برای هر ارائه‌دهنده، و قالب‌بندی زمان سپری‌شده، [تاریخ و زمان](/fa/date-time) را ببینید.

## مرتبط

- [تاریخ و زمان](/fa/date-time) — رفتار و نمونه‌های کامل پوشش/ابزار/پرامپت.
- [Heartbeat](/fa/gateway/heartbeat) — ساعت‌های فعال از منطقه زمانی برای زمان‌بندی استفاده می‌کنند.
- [کارهای Cron](/fa/automation/cron-jobs) — عبارت‌های cron از منطقه زمانی برای زمان‌بندی استفاده می‌کنند.