Naar hoofdinhoud gaan
OpenClaw standaardiseert tijdstempels zodat het model één enkele referentietijd ziet in plaats van een mix van provider-lokale klokken. Er zijn drie oppervlakken waar tijdzones verschijnen, elk met een eigen doel:

​
Drie tijdzone-oppervlakken

OppervlakWat het toontStandaardGeconfigureerd via
Bericht-enveloppenOmhult inkomende kanaalberichten: [Signal +1555 Sun 2026-01-18 00:19:42 PST] helloHost-lokaalagents.defaults.envelopeTimezone
Tool-payloadsKanaaltools in readMessages-stijl retourneren ruwe providertijd + genormaliseerde timestampMs / timestampUtcUTC-velden altijd aanwezigNiet configureerbaar — behoudt provider-native tijdstempels
SysteempromptEen klein Current Date & Time-blok met alleen de tijdzone (geen klokwaarde, voor cachestabiliteit)Hosttijdzone als userTimezone niet is ingesteldagents.defaults.userTimezone
De systeemprompt laat de live klok bewust weg om promptcaching stabiel te houden tussen beurten. Wanneer de agent de huidige tijd nodig heeft, roept deze session_status aan.

​
De gebruikerstijdzone instellen

{
  agents: {
    defaults: {
      userTimezone: "America/Chicago",
    },
  },
}
Als userTimezone niet is ingesteld, bepaalt OpenClaw de hosttijdzone tijdens runtime (zonder configuratie weg te schrijven). agents.defaults.timeFormat (auto | 12 | 24) regelt 12-uurs-/24-uursweergave in enveloppen en downstream-oppervlakken, niet in de systeempromptsectie.

​
Wanneer overschrijven

  • Gebruik UTC-enveloppen (envelopeTimezone: "utc") wanneer je stabiele tijdstempels wilt over hosts in verschillende regio’s heen, of wanneer je UTC-uitgelijnde logs wilt laten overeenkomen met diagnose-uitvoer.
  • Gebruik een vaste IANA-zone (bijv. "Europe/Vienna") wanneer de Gateway-host zich in één zone bevindt maar de gebruiker in een andere, en je wilt dat enveloppen in de zone van de gebruiker worden gelezen ongeacht hostmigratie.
  • Stel envelopeTimestamp: "off" in wanneer tijdstempelcontext niet nuttig is voor het gesprek. Dit verwijdert absolute tijdstempels uit enveloppen, directe agentpromptprefixen en ingesloten modelinvoerprefixen.
Zie Datum en tijd voor de volledige gedragsreferentie, voorbeelden per provider en verstreken-tijd-opmaak.

​
Gerelateerd

  • Datum en tijd — volledig gedrag en voorbeelden voor enveloppen, tools en prompts.
  • Heartbeat — actieve uren gebruiken de tijdzone voor planning.
  • Cron-taken — Cron-expressies gebruiken de tijdzone voor planning.