Przejdź do głównej treści

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw standaryzuje znaczniki czasu, aby model widział jeden czas odniesienia zamiast mieszanki zegarów lokalnych dla dostawców. Strefy czasowe pojawiają się w trzech miejscach, z których każde ma własny cel:

​
Trzy obszary stref czasowych

ObszarCo pokazujeDomyślnieKonfigurowane przez
Koperty wiadomościOpakowuje przychodzące wiadomości kanału: [Signal +1555 2026-01-18 00:19 PST] helloLokalna strefa hostaagents.defaults.envelopeTimezone
Ładunki narzędziNarzędzia kanału w stylu readMessages zwracają surowy czas dostawcy + znormalizowane timestampMs / timestampUtcPola UTC zawsze obecneNie można skonfigurować — zachowuje natywne znaczniki czasu dostawcy
Prompt systemowyMały blok Current Date & Time zawierający tylko 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 bieżący 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 renderowanie w formacie 12h/24h w kopertach i dalszych obszarach, ale nie w sekcji promptu systemowego.

​
Kiedy nadpisywać ustawienia

  • Używaj kopert UTC (envelopeTimezone: "utc"), gdy chcesz mieć stabilne znaczniki czasu na hostach w różnych regionach albo gdy chcesz, aby logi wyrównane do UTC pasowały do danych diagnostycznych.
  • 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" dla kopert o niskim zużyciu tokenów, gdy kontekst znacznika czasu nie jest przydatny w rozmowie.
Pełne omówienie zachowania, przykłady dla poszczególnych dostawców oraz formatowanie czasu, który upłynął, znajdziesz w sekcji Data i godzina.

​
Powiązane

  • Data i godzina — pełne zachowanie kopert/narzędzi/promptu i przykłady.
  • Heartbeat — aktywne godziny używają strefy czasowej do planowania.
  • Zadania Cron — wyrażenia cron używają strefy czasowej do planowania.