> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Saat dilimleri

OpenClaw, modelin sağlayıcıya özgü yerel saatlerin bir karışımı yerine **tek bir referans zamanı** görmesi için zaman damgalarını standartlaştırır. Saat dilimlerinin göründüğü üç yüzey vardır ve her birinin kendi amacı bulunur:

## Üç saat dilimi yüzeyi

| Yüzey          | Ne gösterir                                                                                                          | Varsayılan                                           | Şununla yapılandırılır                                            |
| -------------- | -------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------- | ----------------------------------------------------------------- |
| İleti zarfları | Gelen kanal iletilerini sarar: `[Signal +1555 Sun 2026-01-18 00:19:42 PST] hello`                                    | Ana makine yereli                                    | `agents.defaults.envelopeTimezone`                                |
| Araç yükleri   | Kanal `readMessages` tarzı araçları ham sağlayıcı zamanı + normalleştirilmiş `timestampMs` / `timestampUtc` döndürür | UTC alanları her zaman bulunur                       | Yapılandırılamaz — sağlayıcıya özgü yerel zaman damgalarını korur |
| Sistem istemi  | **Yalnızca saat dilimi** içeren küçük bir `Geçerli Tarih ve Saat` bloğu (önbellek kararlılığı için saat değeri yok)  | `userTimezone` ayarlanmamışsa ana makine saat dilimi | `agents.defaults.userTimezone`                                    |

Sistem istemi, istem önbelleğinin dönüşler arasında kararlı kalması için canlı saati bilerek dışarıda bırakır. Aracının geçerli saate ihtiyacı olduğunda `session_status` çağırır.

## Kullanıcı saat dilimini ayarlama

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  agents: {
    defaults: {
      userTimezone: "America/Chicago",
    },
  },
}
```

`userTimezone` ayarlanmamışsa OpenClaw, çalışma zamanında ana makine saat dilimini çözümler (yapılandırma yazımı yoktur). `agents.defaults.timeFormat` (`auto` | `12` | `24`), sistem istemi bölümünde değil, zarflarda ve aşağı akış yüzeylerinde 12 saat/24 saat gösterimini denetler.

## Ne zaman geçersiz kılmalı

* Farklı bölgelerdeki ana makineler arasında kararlı zaman damgaları istediğinizde veya UTC ile hizalı günlüklerin tanılama çıktısıyla eşleşmesini istediğinizde **UTC zarfları kullanın** (`envelopeTimezone: "utc"`).
* Gateway ana makinesi bir saat dilimindeyken kullanıcı başka bir saat dilimindeyse ve ana makine taşınmasından bağımsız olarak zarfların kullanıcının saat diliminde okunmasını istiyorsanız **sabit bir IANA bölgesi kullanın** (ör. `"Europe/Vienna"`).
* Zaman damgası bağlamı konuşma için yararlı değilse **`envelopeTimestamp: "off"` ayarlayın**. Bu, zarflardan, doğrudan aracı istemi öneklerinden ve gömülü model girdi öneklerinden mutlak zaman damgalarını kaldırır.

Tam davranış başvurusu, sağlayıcı başına örnekler ve geçen süre biçimlendirmesi için [Tarih ve Saat](/tr/date-time) bölümüne bakın.

## İlgili

* [Tarih ve Saat](/tr/date-time) — tam zarf/araç/istem davranışı ve örnekleri.
* [Heartbeat](/tr/gateway/heartbeat) — etkin saatler zamanlama için saat dilimini kullanır.
* [Cron İşleri](/tr/automation/cron-jobs) — cron ifadeleri zamanlama için saat dilimini kullanır.