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ści

Znacznik 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/Chicago

Strefą 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
    },
  },
}

userTimezone ustawia lokalną strefę czasową użytkownika dla kontekstu promptu (oraz dla envelopeTimezone: "user").
timeFormat steruje wyświetlaniem w formacie 12- lub 24-godzinnym dla czasu prezentowanego w prompcie. auto korzysta 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.

CLI commands

RPC and API

Codex harness

Plugin reference

Plugin SDK reference

Plugin maintainer reference

Templates

Technical reference

Concept internals

Project

Contributing

Obwiednie wiadomości (domyślnie lokalne)

Przykłady

Prompt systemowy: bieżąca data i godzina

Wiersze zdarzeń systemowych (domyślnie lokalne)

Konfigurowanie strefy czasowej użytkownika i formatu

Wykrywanie formatu czasu (automatyczne)

Dane narzędzi i konektory (nieprzetworzony czas dostawcy oraz pola znormalizowane)

Powiązana dokumentacja

​Obwiednie wiadomości (domyślnie lokalne)

​Przykłady

​Prompt systemowy: bieżąca data i godzina

​Wiersze zdarzeń systemowych (domyślnie lokalne)

​Konfigurowanie strefy czasowej użytkownika i formatu

​Wykrywanie formatu czasu (automatyczne)

​Dane narzędzi i konektory (nieprzetworzony czas dostawcy oraz pola znormalizowane)

​Powiązana dokumentacja

Obwiednie wiadomości (domyślnie lokalne)

Przykłady

Prompt systemowy: bieżąca data i godzina

Wiersze zdarzeń systemowych (domyślnie lokalne)

Konfigurowanie strefy czasowej użytkownika i formatu

Wykrywanie formatu czasu (automatyczne)

Dane narzędzi i konektory (nieprzetworzony czas dostawcy oraz pola znormalizowane)

Powiązana dokumentacja