---
read_when:
    - می‌خواهید یک مدل ذهنی سریع برای نحوهٔ مدیریت منطقهٔ زمانی داشته باشید
    - شما در حال تصمیم‌گیری هستید که منطقه زمانی را کجا تنظیم یا بازنویسی کنید
summary: محل‌های نمایش منطقه‌های زمانی در OpenClaw — پوش پیام‌ها، بارهای ابزار و پرامپت سیستم
title: مناطق زمانی
x-i18n:
    generated_at: "2026-07-12T09:57:53Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: 9d1620b4b2cedba89bd6ab4392018cd48d0ef92a6abc1744011d482557e2c4fc
    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 همیشه موجودند                            | قابل پیکربندی نیست؛ مُهرهای زمانی بومی ارائه‌دهنده را حفظ می‌کند |
| پرامپت سیستم         | یک بلوک کوچک `تاریخ و زمان فعلی` فقط با **منطقه زمانی** (بدون مقدار ساعت، برای پایداری حافظهٔ نهان)                         | اگر `userTimezone` تنظیم نشده باشد، منطقه زمانی میزبان | `agents.defaults.userTimezone`                        |

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

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

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

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

## مقادیر منطقه زمانی پوشش

`agents.defaults.envelopeTimezone` مقادیر زیر را می‌پذیرد:

- `"local"` (پیش‌فرض) یا `"host"` - منطقه زمانی دستگاه میزبان.
- `"utc"` یا `"gmt"` - UTC.
- `"user"` - مقدار تشخیص‌داده‌شدهٔ `agents.defaults.userTimezone` (اگر تنظیم نشده باشد، به منطقه زمانی میزبان بازمی‌گردد).
- هر رشتهٔ صریح منطقه IANA، برای مثال `"Europe/Vienna"`.

## زمان تغییر مقدار پیش‌فرض

- برای مُهرهای زمانی پایدار میان میزبان‌های مناطق مختلف، یا برای تطبیق با خروجی عیب‌یابی/گزارش هم‌تراز با UTC، **از `"utc"` استفاده کنید**.
- برای هم‌تراز نگه‌داشتن پوشش‌ها با منطقه زمانی پیکربندی‌شدهٔ کاربر، صرف‌نظر از منطقه‌ای که میزبان Gateway در آن اجرا می‌شود، **از `"user"` استفاده کنید**.
- وقتی میزبان Gateway در یک منطقه است اما پوشش باید بدون توجه به جابه‌جایی میزبان همیشه زمان منطقه‌ای دیگر را نشان دهد، **از یک منطقه ثابت IANA استفاده کنید**.
- وقتی زمینهٔ مُهر زمانی برای گفتگو مفید نیست، **`envelopeTimestamp: "off"` را تنظیم کنید**. این کار مُهرهای زمانی مطلق را از پوشش‌ها، پیشوندهای مستقیم پرامپت عامل و پیشوندهای تعبیه‌شدهٔ ورودی مدل حذف می‌کند.

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

## مرتبط

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