Przejdź do głównej treści
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

PowierzchniaCo pokazujeDomyślnieKonfigurowane przez
Koperty wiadomościOwijają przychodzące wiadomości z kanałów: [Signal +1555 Sun 2026-01-18 00:19:42 PST] helloLokalna strefa hostaagents.defaults.envelopeTimezone
Ładunki narzędziNarzędzia kanału w stylu readMessages zwracają surowy czas dostawcy + znormalizowane timestampMs / timestampUtcPola UTC są zawsze obecneNie można konfigurować — zachowuje znaczniki czasu natywne dla dostawcy
Prompt systemowyMał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 ustawioneagents.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.