Tarih ve saat

OpenClaw, taşıma zaman damgaları için ana makinenin yerel saatini kullanır ve sistem istemine yalnızca saat dilimini koyar. Araçların yerel semantiklerini koruması için sağlayıcı zaman damgaları korunur. Aracının geçerli saate ihtiyacı olduğunda session_status aracını çalıştırır.

İleti zarfları (varsayılan olarak yerel)

Gelen iletiler, haftanın günü ve saniye hassasiyetinde bir zaman damgasıyla sarmalanır:

[WhatsApp +1555 Mon 2026-01-05 16:26:34 PST] ileti metni

Zarf zaman damgası, sağlayıcının saat diliminden bağımsız olarak varsayılan biçimde ana makinenin yerel saatidir. agents.defaults altında geçersiz kılın:

{
  agents: {
    defaults: {
      envelopeTimezone: "local", // "utc" | "local" | "user" | IANA saat dilimi
      envelopeTimestamp: "on", // "on" | "off"
      envelopeElapsed: "on", // "on" | "off"
    },
  },
}

Anahtar	Değerler	Davranış
`envelopeTimezone`	`local` (varsayılan), `utc`, `user`, açık IANA adı	`user`, `agents.defaults.userTimezone` değerini kullanır (ayarlanmadığında ana makinenin saat dilimi). Açık bir IANA adı (ör. `"America/Chicago"`) sabit bir bölge belirler; tanınmayan adlar için UTC’ye geri dönülür.
`envelopeTimestamp`	`on` (varsayılan), `off`	`off`, zarf başlıklarından, doğrudan aracı istemi öneklerinden ve gömülü model girdisi öneklerinden mutlak zaman damgalarını kaldırır.
`envelopeElapsed`	`on` (varsayılan), `off`	`off`, oturumdaki önceki iletiden bu yana geçen süreyi gösteren son eki (`+30s` / `+2m` biçimi) kaldırır.

Örnekler

Yerel (varsayılan):

[WhatsApp +1555 Sun 2026-01-18 00:19:42 PST] merhaba

Kullanıcının saat dilimi:

[WhatsApp +1555 Sun 2026-01-18 00:19:42 CST] merhaba

envelopeTimezone: "utc" ile geçen süre:

[WhatsApp +1555 +30s Sun 2026-01-18T05:19:00Z] takip iletisi

Sistem istemi: geçerli tarih ve saat

İstem önbelleğe almanın kararlı kalması için sistem istemi, yalnızca saat dilimini (saat veya saat biçimi olmadan) içeren bir Geçerli Tarih ve Saat bölümü içerir:

Saat dilimi: America/Chicago

Yapılandırıldığında bölge agents.defaults.userTimezone, aksi takdirde ana makinenin saat dilimidir. İstem ayrıca, geçerli tarih, saat veya haftanın gününe ihtiyaç duyduğunda ajana session_status aracını çalıştırmasını söyler.

Sistem olay satırları (varsayılan olarak yerel)

Ajan bağlamına eklenen kuyruğa alınmış sistem olaylarının önüne, ileti zarflarıyla aynı envelopeTimezone seçimi kullanılarak bir zaman damgası eklenir (varsayılan: ana makine yereli).

System: [2026-01-12 12:19:17 PST] Model değiştirildi.

Kullanıcı saat dilimini ve biçimini yapılandırma

{
  agents: {
    defaults: {
      userTimezone: "America/Chicago",
      timeFormat: "auto", // auto | 12 | 24
    },
  },
}

userTimezone, istem bağlamı (ve envelopeTimezone: "user") için kullanıcının yerel saat dilimini ayarlar.
timeFormat, istemde gösterilen saatlerin 12 saatlik/24 saatlik gösterimini denetler. auto, işletim sistemi tercihlerini izler.

Saat biçimi algılama (otomatik)

timeFormat: "auto" olduğunda OpenClaw, işletim sistemi tercihini (macOS ve Windows) inceler ve yerel ayar biçimlendirmesini kullanır. Algılanan değer, yinelenen sistem çağrılarını önlemek için işlem başına önbelleğe alınır.

Araç yükleri + bağlayıcılar (ham sağlayıcı zamanı + normalleştirilmiş alanlar)

Kanal araçları, tutarlılık için sağlayıcıya özgü zaman damgalarını döndürür ve normalleştirilmiş alanlar ekler:

timestampMs: epoch milisaniyesi (UTC)
timestampUtc: ISO 8601 UTC dizesi

Hiçbir şeyin kaybolmaması için ham sağlayıcı alanları korunur.

Discord: UTC ISO zaman damgaları
Slack: API’den gelen epoch benzeri dizeler
Telegram/WhatsApp: sağlayıcıya özgü sayısal/ISO zaman damgaları

Yerel saate ihtiyaç duyulursa bilinen saat dilimini kullanarak sonraki aşamada dönüştürün.

CLI commands

RPC and API

Codex harness

Plugin reference

Plugin SDK reference

Plugin maintainer reference

Templates

Technical reference

Concept internals

Project

Contributing

İleti zarfları (varsayılan olarak yerel)

Örnekler

Sistem istemi: geçerli tarih ve saat

Sistem olay satırları (varsayılan olarak yerel)

Kullanıcı saat dilimini ve biçimini yapılandırma

Saat biçimi algılama (otomatik)

Araç yükleri + bağlayıcılar (ham sağlayıcı zamanı + normalleştirilmiş alanlar)

İlgili belgeler

​İleti zarfları (varsayılan olarak yerel)

​Örnekler

​Sistem istemi: geçerli tarih ve saat

​Sistem olay satırları (varsayılan olarak yerel)

​Kullanıcı saat dilimini ve biçimini yapılandırma

​Saat biçimi algılama (otomatik)

​Araç yükleri + bağlayıcılar (ham sağlayıcı zamanı + normalleştirilmiş alanlar)

​İlgili belgeler

İleti zarfları (varsayılan olarak yerel)

Örnekler

Sistem istemi: geçerli tarih ve saat

Sistem olay satırları (varsayılan olarak yerel)

Kullanıcı saat dilimini ve biçimini yapılandırma

Saat biçimi algılama (otomatik)

Araç yükleri + bağlayıcılar (ham sağlayıcı zamanı + normalleştirilmiş alanlar)

İlgili belgeler