Saat dilimleri

OpenClaw, zaman damgalarını standartlaştırır; böylece model, sağlayıcıya yerel saatlerin karışımı yerine tek bir referans zamanı gö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
Mesaj zarfları	Gelen kanal mesajlarını sarmalar: [Signal +1555 2026-01-18 00:19 PST] merhaba	Ana makineye yerel	agents.defaults.envelopeTimezone
Araç yükleri	Kanalın readMessages tarzı araçları ham sağlayıcı zamanını + normalleştirilmiş timestampMs / timestampUtc döndürür	UTC alanları her zaman bulunur	Yapılandırılamaz — sağlayıcıya özgü zaman damgalarını korur
Sistem istemi	Yalnızca saat dilimini içeren küçük bir Current Date & Time 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ğe almayı dönüşler arasında kararlı tutmak için canlı saati özellikle çıkarır. Aracının geçerli zamana 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 çözer (yapılandırma yazımı yok). agents.defaults.timeFormat (auto | 12 | 24), sistem istemi bölümünde değil, zarflarda ve aşağı akış yüzeylerde 12s/24s 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 geçişinden 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 düşük token'lı zarflar için envelopeTimestamp: "off" ayarlayın.

Tam davranış başvurusu, sağlayıcı başına örnekler ve geçen süre biçimlendirmesi için bkz. Tarih ve Saat.

# İlgili

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