Technical reference
Datum en tijd
OpenClaw gebruikt hostlokale tijd voor transporttijdstempels en neemt alleen de tijdzone op in de systeemprompt.
Tijdstempels van providers blijven behouden, zodat tools hun eigen semantiek behouden. Wanneer de agent de huidige
tijd nodig heeft, voert deze de tool session_status uit.
Berichtomslagen (standaard lokaal)
Inkomende berichten worden omhuld met een weekdag en een tijdstempel met precisie tot op de seconde:
[WhatsApp +1555 Mon 2026-01-05 16:26:34 PST] message textDe tijdstempel van de omslag is standaard hostlokaal, ongeacht de tijdzone van de provider.
Overschrijf dit onder agents.defaults:
{ agents: { defaults: { envelopeTimezone: "local", // "utc" | "local" | "user" | IANA-tijdzone envelopeTimestamp: "on", // "on" | "off" envelopeElapsed: "on", // "on" | "off" }, },}| Sleutel | Waarden | Gedrag |
|---|---|---|
envelopeTimezone |
local (standaard), utc, user, expliciete IANA-naam |
user gebruikt agents.defaults.userTimezone (de tijdzone van de host wanneer niet ingesteld). Een expliciete IANA-naam (bijv. "America/Chicago") legt een vaste zone vast; niet-herkende namen vallen terug op UTC. |
envelopeTimestamp |
on (standaard), off |
off verwijdert absolute tijdstempels uit omslagkoppen, directe voorvoegsels van agentprompts en ingebedde voorvoegsels voor modelinvoer. |
envelopeElapsed |
on (standaard), off |
off verwijdert het achtervoegsel voor verstreken tijd (in de stijl van +30s / +2m) dat de tijd sinds het vorige bericht in de sessie aangeeft. |
Voorbeelden
Lokaal (standaard):
[WhatsApp +1555 Sun 2026-01-18 00:19:42 PST] helloTijdzone van de gebruiker:
[WhatsApp +1555 Sun 2026-01-18 00:19:42 CST] helloVerstreken tijd met envelopeTimezone: "utc":
[WhatsApp +1555 +30s Sun 2026-01-18T05:19:00Z] follow-upSysteemprompt: huidige datum en tijd
De systeemprompt bevat een sectie Huidige datum en tijd met alleen de tijdzone (geen klok of tijdnotatie), zodat promptcaching stabiel blijft:
Tijdzone: America/ChicagoDe zone is agents.defaults.userTimezone wanneer deze is geconfigureerd; anders wordt de tijdzone van de host gebruikt.
De prompt instrueert de agent ook om de tool session_status uit te voeren wanneer deze de huidige
datum, tijd of dag van de week nodig heeft.
Systeemgebeurtenisregels (standaard lokaal)
Systeemgebeurtenissen in de wachtrij die in de agentcontext worden ingevoegd, krijgen een tijdstempel als voorvoegsel, met
dezelfde selectie voor envelopeTimezone als berichtomslagen (standaard: hostlokaal).
System: [2026-01-12 12:19:17 PST] Model switched.Tijdzone en notatie voor de gebruiker configureren
{ agents: { defaults: { userTimezone: "America/Chicago", timeFormat: "auto", // auto | 12 | 24 }, },}userTimezonestelt de gebruikerslokale tijdzone in voor de promptcontext (en voorenvelopeTimezone: "user").timeFormatbepaalt de 12-/24-uursweergave voor tijden in prompts.autovolgt de voorkeuren van het besturingssysteem.
Detectie van tijdnotatie (automatisch)
Wanneer timeFormat: "auto" is ingesteld, controleert OpenClaw de voorkeur van het besturingssysteem (macOS en Windows)
en valt het terug op de lokale notatie. De gedetecteerde waarde wordt per proces gecachet
om herhaalde systeemaanroepen te voorkomen.
Toolpayloads en connectors (onbewerkte providertijd en genormaliseerde velden)
Kanaaltools retourneren tijdstempels in de eigen notatie van de provider en voegen voor consistentie genormaliseerde velden toe:
timestampMs: milliseconden sinds de epoch (UTC)timestampUtc: ISO 8601-tekenreeks in UTC
Onbewerkte providervelden blijven behouden, zodat er niets verloren gaat.
- Discord: ISO-tijdstempels in UTC
- Slack: epoch-achtige tekenreeksen uit de API
- Telegram/WhatsApp: providerspecifieke numerieke/ISO-tijdstempels
Als u lokale tijd nodig hebt, converteert u deze verderop met behulp van de bekende tijdzone.
