Ana içeriğe atla
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üzeyNe gösterirVarsayılanŞununla yapılandırılır
İleti zarflarıGelen kanal iletilerini sarar: [Signal +1555 Sun 2026-01-18 00:19:42 PST] helloAna makine yereliagents.defaults.envelopeTimezone
Araç yükleriKanal readMessages tarzı araçları ham sağlayıcı zamanı + normalleştirilmiş timestampMs / timestampUtc döndürürUTC alanları her zaman bulunurYapılandırılamaz — sağlayıcıya özgü yerel zaman damgalarını korur
Sistem istemiYalnı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 dilimiagents.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

{
  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 bölümüne bakın.

​
İlgili

  • Tarih ve Saat — tam zarf/araç/istem davranışı ve örnekleri.
  • Heartbeat — etkin saatler zamanlama için saat dilimini kullanır.
  • Cron İşleri — cron ifadeleri zamanlama için saat dilimini kullanır.