Technical reference
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 metniZarf 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] merhabaKullanıcının saat dilimi:
[WhatsApp +1555 Sun 2026-01-18 00:19:42 CST] merhabaenvelopeTimezone: "utc" ile geçen süre:
[WhatsApp +1555 +30s Sun 2026-01-18T05:19:00Z] takip iletisiSistem 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/ChicagoYapı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ı (veenvelopeTimezone: "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.
