Concept internals
Saat Dilimleri
OpenClaw, modelin sağlayıcıya özgü saatlerin bir karışımı yerine tek bir referans zamanı görmesi için zaman damgalarını standartlaştırır. Üç yüzey saat dilimlerini gösterir ve her birinin farklı bir amacı vardır:
Üç saat dilimi yüzeyi
| Yüzey | Gösterdiği | Varsayılan | Yapılandırma yolu |
|---|---|---|---|
| İleti zarfları | Gelen kanal iletilerini sarar: [Signal +1555 Sun 2026-01-18 00:19:42 PST] hello |
Ana makinenin yerel saat dilimi | agents.defaults.envelopeTimezone |
| Araç yükleri | Kanalın readMessages tarzı araçları, ham sağlayıcı zamanının yanı sıra normalleştirilmiş timestampMs / timestampUtc değerlerini 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 Geçerli Tarih ve Saat bloğu (önbellek kararlılığı için saat değeri yoktur) |
userTimezone ayarlanmamışsa ana makinenin saat dilimi |
agents.defaults.userTimezone |
Sistem istemi, istem önbelleğe alımını turlar arasında kararlı tutmak için güncel saati bilinçli olarak içermez. Temsilci geçerli saate ihtiyaç duyduğunda session_status çağrısı yapar.
Kullanıcı saat dilimini ayarlama
{ agents: { defaults: { userTimezone: "America/Chicago", }, },}userTimezone ayarlanmamışsa OpenClaw, çalışma zamanında ana makinenin saat dilimini Intl.DateTimeFormat().resolvedOptions().timeZone aracılığıyla çözümler (yapılandırmaya yazmaz). agents.defaults.timeFormat (auto | 12 | 24), sistem istemi bölümünde değil, zarflarda ve sonraki yüzeylerde 12/24 saatlik gösterimi denetler.
Zarf saat dilimi değerleri
agents.defaults.envelopeTimezone şu değerleri kabul eder:
"local"(varsayılan) veya"host"- ana makinenin saat dilimi."utc"veya"gmt"- UTC."user"- çözümlenmişagents.defaults.userTimezonedeğeri (ayarlanmamışsa ana makinenin saat dilimine geri döner).- Herhangi bir açık IANA bölge dizesi; örneğin
"Europe/Vienna".
Ne zaman geçersiz kılınmalı?
- Farklı bölgelerdeki ana makineler arasında kararlı zaman damgaları sağlamak veya UTC ile uyumlu tanılama/günlük çıktısıyla eşleşmek için
"utc"kullanın. - Gateway ana makinesinin çalıştığı bölgeden bağımsız olarak zarfları yapılandırılmış kullanıcı saat dilimiyle uyumlu tutmak için
"user"kullanın. - Gateway ana makinesi bir bölgedeyken zarfın, ana makine taşınsa bile her zaman başka bir bölgenin saatini göstermesi gerektiğinde sabit bir IANA bölgesi kullanın.
- Zaman damgası bağlamı konuşma için yararlı olmadığında
envelopeTimestamp: "off"ayarlayın. Bu, mutlak zaman damgalarını zarflardan, doğrudan temsilci istemi öneklerinden ve gömülü model girdisi öneklerinden kaldırır.
Davranışın tam başvurusu, sağlayıcı bazında örnekler ve geçen süre biçimlendirmesi için Tarih ve Saat bölümüne bakın.
İlgili
- Tarih ve Saat - zarf/araç/istem davranışının tamamı ve örnekler.
- Heartbeat - etkin saatler, zamanlama için saat dilimini kullanır.
- Cron İşleri - cron ifadeleri, zamanlama için saat dilimini kullanır.
