Concept internals
Tijdzones
OpenClaw standaardiseert tijdstempels, zodat het model één referentietijd ziet in plaats van een combinatie van providerlokale klokken. Drie oppervlakken tonen tijdzones, elk met een eigen doel:
Drie tijdzoneoppervlakken
| Oppervlak | Wat het toont | Standaardwaarde | Geconfigureerd via |
|---|---|---|---|
| Berichtomslagen | Omsluit inkomende kanaalberichten: [Signal +1555 Sun 2026-01-18 00:19:42 PST] hello |
Lokaal op de host | agents.defaults.envelopeTimezone |
| Toolpayloads | Kanaaltools in readMessages-stijl retourneren de onbewerkte providertijd plus genormaliseerde timestampMs / timestampUtc |
UTC-velden zijn altijd aanwezig | Niet configureerbaar; behoudt provider-eigen tijdstempels |
| Systeemprompt | Een klein Current Date & Time-blok met alleen de tijdzone (geen klokwaarde, voor stabiele caching) |
Tijdzone van de host als userTimezone niet is ingesteld |
agents.defaults.userTimezone |
De systeemprompt laat de actuele klok bewust weg om promptcaching tussen beurten stabiel te houden. Wanneer de agent de huidige tijd nodig heeft, roept deze session_status aan.
De tijdzone van de gebruiker instellen
{ agents: { defaults: { userTimezone: "America/Chicago", }, },}Als userTimezone niet is ingesteld, bepaalt OpenClaw tijdens runtime de tijdzone van de host via Intl.DateTimeFormat().resolvedOptions().timeZone (zonder configuratie weg te schrijven). agents.defaults.timeFormat (auto | 12 | 24) regelt de 12-uurs-/24-uursweergave in omslagen en verdere oppervlakken, maar niet in het systeempromptgedeelte.
Tijdzonewaarden voor omslagen
agents.defaults.envelopeTimezone accepteert:
"local"(standaard) of"host"- de tijdzone van de hostmachine."utc"of"gmt"- UTC."user"- de bepaaldeagents.defaults.userTimezone(valt terug op de tijdzone van de host als deze niet is ingesteld).- Elke expliciete IANA-tijdzonetekenreeks, bijvoorbeeld
"Europe/Vienna".
Wanneer overschrijven
- Gebruik
"utc"voor consistente tijdstempels op hosts in verschillende regio's, of om aan te sluiten bij diagnostische uitvoer/loguitvoer die op UTC is afgestemd. - Gebruik
"user"om omslagen afgestemd te houden op de geconfigureerde tijdzone van de gebruiker, ongeacht de tijdzone waarin de Gateway-host draait. - Gebruik een vaste IANA-tijdzone wanneer de Gateway-host zich in één tijdzone bevindt, maar de omslag altijd een andere tijdzone moet weergeven, ongeacht een migratie van de host.
- Stel
envelopeTimestamp: "off"in wanneer tijdstempelcontext niet nuttig is voor het gesprek. Hiermee worden absolute tijdstempels verwijderd uit omslagen, directe promptvoorvoegsels voor agents en ingebedde voorvoegsels voor modelinvoer.
Zie Datum en tijd voor de volledige gedragsreferentie, voorbeelden per provider en de opmaak van verstreken tijd.
Gerelateerd
- Datum en tijd - volledig gedrag en voorbeelden voor omslagen, tools en prompts.
- Heartbeat - actieve uren gebruiken de tijdzone voor planning.
- Cron-taken - cron-expressies gebruiken de tijdzone voor planning.
