Naar hoofdinhoud gaan

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.

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 zichtbaar zijn, elk met een eigen doel:

​
Drie tijdzone-oppervlakken

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

​
De gebruikerstijdzone instellen

{
  agents: {
    defaults: {
      userTimezone: "America/Chicago",
    },
  },
}
Als userTimezone niet is ingesteld, bepaalt OpenClaw de hosttijdzone tijdens runtime (zonder config te schrijven). agents.defaults.timeFormat (auto | 12 | 24) bepaalt de 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 tussen hosts in verschillende regio’s, of wanneer je UTC-uitgelijnde logs wilt laten overeenkomen met diagnostische 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 weergegeven, ongeacht hostmigratie.
  • Stel envelopeTimestamp: "off" in voor enveloppen met weinig tokens wanneer tijdstempelcontext niet nuttig is voor het gesprek.
Zie Datum en tijd voor de volledige gedragsreferentie, voorbeelden per provider en opmaak van verstreken tijd.

​
Gerelateerd

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