Concept internals
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
{ 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.
