Technical reference
Data i godzina
OpenClaw używa czasu lokalnego hosta dla znaczników czasu transportu i umieszcza w prompcie systemowym tylko strefę czasową.
Znaczniki czasu dostawcy są zachowywane, dzięki czemu narzędzia zachowują swoją natywną semantykę. Gdy agent potrzebuje bieżącego
czasu, uruchamia narzędzie session_status.
Obwiednie wiadomości (domyślnie lokalne)
Wiadomości przychodzące są opakowywane znacznikiem czasu zawierającym dzień tygodnia i czas z dokładnością do sekundy:
[WhatsApp +1555 Mon 2026-01-05 16:26:34 PST] treść wiadomościZnacznik czasu obwiedni jest domyślnie zgodny z czasem lokalnym hosta, niezależnie od strefy czasowej dostawcy.
Można to zmienić w agents.defaults:
{ agents: { defaults: { envelopeTimezone: "local", // "utc" | "local" | "user" | strefa czasowa IANA envelopeTimestamp: "on", // "on" | "off" envelopeElapsed: "on", // "on" | "off" }, },}| Klucz | Wartości | Zachowanie |
|---|---|---|
envelopeTimezone |
local (domyślnie), utc, user, jawna nazwa IANA |
user używa agents.defaults.userTimezone (strefy czasowej hosta, jeśli nie ustawiono). Jawna nazwa IANA (np. "America/Chicago") ustala stałą strefę; nierozpoznane nazwy powodują użycie UTC. |
envelopeTimestamp |
on (domyślnie), off |
off usuwa bezwzględne znaczniki czasu z nagłówków obwiedni, bezpośrednich prefiksów promptów agenta oraz osadzonych prefiksów danych wejściowych modelu. |
envelopeElapsed |
on (domyślnie), off |
off usuwa przyrostek czasu, który upłynął od poprzedniej wiadomości w sesji (w formacie takim jak +30s / +2m). |
Przykłady
Czas lokalny (domyślnie):
[WhatsApp +1555 Sun 2026-01-18 00:19:42 PST] cześćStrefa czasowa użytkownika:
[WhatsApp +1555 Sun 2026-01-18 00:19:42 CST] cześćCzas, który upłynął, z envelopeTimezone: "utc":
[WhatsApp +1555 +30s Sun 2026-01-18T05:19:00Z] kolejna wiadomośćPrompt systemowy: bieżąca data i godzina
Prompt systemowy zawiera sekcję Bieżąca data i godzina z samą strefą czasową (bez zegara ani formatu czasu), dzięki czemu pamięć podręczna promptu pozostaje stabilna:
Strefa czasowa: America/ChicagoStrefą jest agents.defaults.userTimezone, jeśli ją skonfigurowano, a w przeciwnym razie strefa czasowa hosta.
Prompt instruuje również agenta, aby uruchamiał narzędzie session_status, gdy potrzebuje
bieżącej daty, godziny lub dnia tygodnia.
Wiersze zdarzeń systemowych (domyślnie lokalne)
Zdarzenia systemowe umieszczone w kolejce i wstawiane do kontekstu agenta są poprzedzane znacznikiem czasu przy użyciu
tego samego ustawienia envelopeTimezone co obwiednie wiadomości (domyślnie: czas lokalny hosta).
System: [2026-01-12 12:19:17 PST] Model został przełączony.Konfigurowanie strefy czasowej użytkownika i formatu
{ agents: { defaults: { userTimezone: "America/Chicago", timeFormat: "auto", // auto | 12 | 24 }, },}userTimezoneustawia lokalną strefę czasową użytkownika dla kontekstu promptu (oraz dlaenvelopeTimezone: "user").timeFormatsteruje wyświetlaniem w formacie 12- lub 24-godzinnym dla czasu prezentowanego w prompcie.autokorzysta z preferencji systemu operacyjnego.
Wykrywanie formatu czasu (automatyczne)
Gdy ustawiono timeFormat: "auto", OpenClaw sprawdza preferencje systemu operacyjnego (macOS i Windows),
a jeśli nie jest to możliwe, używa formatowania zgodnego z ustawieniami regionalnymi. Wykryta wartość jest buforowana dla procesu,
aby uniknąć powtarzających się wywołań systemowych.
Dane narzędzi i konektory (nieprzetworzony czas dostawcy oraz pola znormalizowane)
Narzędzia kanałów zwracają natywne znaczniki czasu dostawcy i dla spójności dodają znormalizowane pola:
timestampMs: liczba milisekund od epoki (UTC)timestampUtc: ciąg UTC w formacie ISO 8601
Nieprzetworzone pola dostawcy są zachowywane, aby nie utracić żadnych informacji.
- Discord: znaczniki czasu UTC w formacie ISO
- Slack: ciągi przypominające czas epoki zwracane przez API
- Telegram/WhatsApp: specyficzne dla dostawcy znaczniki czasu w formacie liczbowym lub ISO
Jeśli potrzebujesz czasu lokalnego, przekształć go na dalszym etapie przy użyciu znanej strefy czasowej.
