Concept internals
Strefy czasowe
OpenClaw standaryzuje znaczniki czasu, aby model widział jeden czas referencyjny zamiast mieszanki zegarów lokalnych dla dostawców. Istnieją trzy powierzchnie, na których pojawiają się strefy czasowe, każda z własnym celem:
Trzy powierzchnie stref czasowych
| Powierzchnia | Co pokazuje | Domyślnie | Konfigurowane przez |
|---|---|---|---|
| Koperty wiadomości | Owijają przychodzące wiadomości z kanałów: [Signal +1555 Sun 2026-01-18 00:19:42 PST] hello |
Lokalna strefa hosta | agents.defaults.envelopeTimezone |
| Ładunki narzędzi | Narzędzia kanału w stylu readMessages zwracają surowy czas dostawcy + znormalizowane timestampMs / timestampUtc |
Pola UTC są zawsze obecne | Nie można konfigurować — zachowuje znaczniki czasu natywne dla dostawcy |
| Prompt systemowy | Mały blok Current Date & Time z samą strefą czasową (bez wartości zegara, dla stabilności cache) |
Strefa czasowa hosta, jeśli userTimezone nie jest ustawione |
agents.defaults.userTimezone |
Prompt systemowy celowo pomija aktualny zegar, aby cache promptów pozostawał stabilny między turami. Gdy agent potrzebuje bieżącego czasu, wywołuje session_status.
Ustawianie strefy czasowej użytkownika
{ agents: { defaults: { userTimezone: "America/Chicago", }, },}Jeśli userTimezone nie jest ustawione, OpenClaw ustala strefę czasową hosta w czasie działania (bez zapisu konfiguracji). agents.defaults.timeFormat (auto | 12 | 24) kontroluje formatowanie 12h/24h w kopertach i powierzchniach niższego poziomu, ale nie w sekcji promptu systemowego.
Kiedy nadpisywać
- Używaj kopert UTC (
envelopeTimezone: "utc"), gdy chcesz mieć stabilne znaczniki czasu między hostami w różnych regionach albo gdy chcesz, aby logi wyrównane do UTC pasowały do danych wyjściowych diagnostyki. - Używaj stałej strefy IANA (np.
"Europe/Vienna"), gdy host Gateway znajduje się w jednej strefie, ale użytkownik w innej, i chcesz, aby koperty były odczytywane w strefie użytkownika niezależnie od migracji hosta. - Ustaw
envelopeTimestamp: "off", gdy kontekst znacznika czasu nie jest przydatny w rozmowie. Usuwa to bezwzględne znaczniki czasu z kopert, bezpośrednich prefiksów promptów agenta i osadzonych prefiksów wejścia modelu.
Pełny opis zachowania, przykłady dla poszczególnych dostawców oraz formatowanie czasu, który upłynął, znajdziesz w Data i godzina.
Powiązane
- Data i godzina — pełne zachowanie kopert/narzędzi/promptów oraz przykłady.
- Heartbeat — aktywne godziny używają strefy czasowej do planowania.
- Zadania Cron — wyrażenia Cron używają strefy czasowej do planowania.
