---
read_when:
    - شما در حال تغییر نحوهٔ نمایش برچسب‌های زمانی به مدل یا کاربران هستید
    - در حال اشکال‌زدایی قالب‌بندی زمان در پیام‌ها یا خروجی پرامپت سیستم هستید
summary: مدیریت تاریخ و زمان در سراسر پوشش‌ها، پرامپت‌ها، ابزارها و رابط‌ها
title: تاریخ و زمان
x-i18n:
    generated_at: "2026-05-06T09:15:32Z"
    model: gpt-5.5
    provider: openai
    source_hash: 5f695a5009c949cc24689bfb8950d96cf72f0b2a1472efe88923182527b56b74
    source_path: date-time.md
    workflow: 16
---

OpenClaw به‌طور پیش‌فرض از **زمان محلی میزبان برای مهرهای زمانی انتقال** و **منطقه زمانی کاربر فقط در پرامپت سیستم** استفاده می‌کند.
مهرهای زمانی ارائه‌دهنده حفظ می‌شوند تا ابزارها معنای بومی خود را نگه دارند (زمان فعلی از طریق `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
```

## پرامپت سیستم: تاریخ و زمان فعلی

اگر منطقه زمانی کاربر شناخته شده باشد، پرامپت سیستم یک بخش اختصاصی
**تاریخ و زمان فعلی** را با **فقط منطقه زمانی** (بدون قالب ساعت/زمان)
در بر می‌گیرد تا کش کردن پرامپت پایدار بماند:

```
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` **منطقه زمانی محلی کاربر** را برای زمینه پرامپت تنظیم می‌کند.
- `timeFormat` **نمایش 12 ساعته/24 ساعته** را در پرامپت کنترل می‌کند. `auto` از ترجیحات سیستم‌عامل پیروی می‌کند.

## تشخیص قالب زمان (خودکار)

وقتی `timeFormat: "auto"` باشد، OpenClaw ترجیح سیستم‌عامل (macOS/Windows)
را بررسی می‌کند و در صورت نبود، به قالب‌بندی locale برمی‌گردد. مقدار تشخیص‌داده‌شده **برای هر فرایند کش می‌شود**
تا از فراخوانی‌های تکراری سیستم جلوگیری شود.

## محموله‌های ابزار + رابط‌ها (زمان خام ارائه‌دهنده + فیلدهای نرمال‌شده)

ابزارهای کانال **مهرهای زمانی بومی ارائه‌دهنده** را برمی‌گردانند و برای یکدستی، فیلدهای نرمال‌شده اضافه می‌کنند:

- `timestampMs`: میلی‌ثانیه‌های epoch (UTC)
- `timestampUtc`: رشته UTC با قالب ISO 8601

فیلدهای خام ارائه‌دهنده حفظ می‌شوند تا چیزی از دست نرود.

- Slack: رشته‌های شبیه epoch از API
- Discord: مهرهای زمانی ISO با UTC
- Telegram/WhatsApp: مهرهای زمانی عددی/ISO ویژه ارائه‌دهنده

اگر به زمان محلی نیاز دارید، آن را در پایین‌دست با استفاده از منطقه زمانی شناخته‌شده تبدیل کنید.

## مستندات مرتبط

- [پرامپت سیستم](/fa/concepts/system-prompt)
- [مناطق زمانی](/fa/concepts/timezone)
- [پیام‌ها](/fa/concepts/messages)