Ana içeriğe atla
OpenClaw, varsayılan olarak aktarım zaman damgaları için ana makine yerel saatini ve yalnızca sistem isteminde kullanıcı saat dilimini kullanır. Sağlayıcı zaman damgaları korunur; böylece araçlar yerel anlamlarını korur (geçerli saat session_status üzerinden kullanılabilir).

​
Mesaj zarfları (varsayılan olarak yerel)

Gelen mesajlar bir zaman damgasıyla (saniye hassasiyetinde) sarmalanır: 
[Provider ... Mon 2026-01-05 16:26:34 PST] message text
Bu zarf zaman damgası, sağlayıcı saat diliminden bağımsız olarak varsayılan olarak ana makine yerel saatindedir. Bu davranışı geçersiz kılabilirsiniz: 
{
  agents: {
    defaults: {
      envelopeTimezone: "local", // "utc" | "local" | "user" | IANA timezone
      envelopeTimestamp: "on", // "on" | "off"
      envelopeElapsed: "on", // "on" | "off"
    },
  },
}
  • envelopeTimezone: "utc" UTC kullanır.
  • envelopeTimezone: "local" ana makine saat dilimini kullanır.
  • envelopeTimezone: "user" agents.defaults.userTimezone değerini kullanır (ana makine saat dilimine geri döner).
  • Sabit bir bölge için açık bir IANA saat dilimi (ör. "America/Chicago") kullanın.
  • envelopeTimestamp: "off" zarf başlıklarından, doğrudan ajan istemi öneklerinden ve gömülü model girdisi öneklerinden mutlak zaman damgalarını kaldırır.
  • envelopeElapsed: "off" geçen süre soneklerini (+2m biçimi) kaldırır.

​
Örnekler

Yerel (varsayılan): 
[WhatsApp +1555 Sun 2026-01-18 00:19:42 PST] hello
Kullanıcı saat dilimi: 
[WhatsApp +1555 Sun 2026-01-18 00:19:42 CST] hello
Geçen süre etkin: 
[WhatsApp +1555 +30s Sun 2026-01-18T05:19:00Z] follow-up

​
Sistem istemi: geçerli tarih ve saat

Kullanıcı saat dilimi biliniyorsa sistem istemi, istem önbelleğe almayı kararlı tutmak için yalnızca saat dilimini içeren (saat/zaman biçimi yok) özel bir Geçerli Tarih ve Saat bölümü içerir: 
Time zone: America/Chicago
Ajan geçerli saate ihtiyaç duyduğunda session_status aracını kullanın; durum kartı bir zaman damgası satırı içerir.

​
Sistem olayı satırları (varsayılan olarak yerel)

Ajan bağlamına eklenen kuyruğa alınmış sistem olaylarının başına, mesaj zarflarıyla aynı saat dilimi seçimi kullanılarak bir zaman damgası eklenir (varsayılan: ana makine yerel). 
System: [2026-01-12 12:19:17 PST] Model switched.

​
Kullanıcı saat dilimini ve biçimini yapılandırma

{
  agents: {
    defaults: {
      userTimezone: "America/Chicago",
      timeFormat: "auto", // auto | 12 | 24
    },
  },
}
  • userTimezone, istem bağlamı için kullanıcı yerel saat dilimini ayarlar.
  • timeFormat, istemde 12 saat/24 saat gösterimini denetler. auto, işletim sistemi tercihlerini izler.

​
Saat biçimi algılama (auto)

timeFormat: "auto" olduğunda OpenClaw işletim sistemi tercihini (macOS/Windows) inceler ve yerel ayar biçimlendirmesine geri döner. 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ı sağlayıcıya özgü zaman damgaları döndürür ve tutarlılık için normalleştirilmiş alanlar ekler:
  • timestampMs: epoch milisaniyeleri (UTC)
  • timestampUtc: ISO 8601 UTC dizesi
Ham sağlayıcı alanları korunur; böylece hiçbir şey kaybolmaz.
  • Slack: API’den gelen epoch benzeri dizeler
  • Discord: UTC ISO zaman damgaları
  • Telegram/WhatsApp: sağlayıcıya özgü sayısal/ISO zaman damgaları
Yerel saate ihtiyacınız varsa bilinen saat dilimini kullanarak bunu aşağı akışta dönüştürün.

​
İlgili dokümanlar