> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  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](/pl/date-time).

## Powiązane

* [Data i godzina](/pl/date-time) — pełne zachowanie kopert/narzędzi/promptów oraz przykłady.
* [Heartbeat](/pl/gateway/heartbeat) — aktywne godziny używają strefy czasowej do planowania.
* [Zadania Cron](/pl/automation/cron-jobs) — wyrażenia Cron używają strefy czasowej do planowania.