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.
Berichtomhulsels (standaard lokaal)
Inkomende berichten worden voorzien van een weekdag en een tijdstempel met precisie tot op de seconde:
[WhatsApp +1555 Mon 2026-01-05 16:26:34 PST] berichttekstDe tijdstempel van het omhulsel 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 (hosttijdzone 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 omhulselkoppen, directe voorvoegsels van agentprompts en ingebedde voorvoegsels van modelinvoer. |
envelopeElapsed |
on (standaard), off |
off verwijdert het achtervoegsel met verstreken tijd (in de stijl +30s / +2m) dat de tijd sinds het vorige bericht in de sessie toont. |
Voorbeelden
Lokaal (standaard):
[WhatsApp +1555 Sun 2026-01-18 00:19:42 PST] halloTijdzone van de gebruiker:
[WhatsApp +1555 Sun 2026-01-18 00:19:42 CST] halloVerstreken tijd met envelopeTimezone: "utc":
[WhatsApp +1555 +30s Sun 2026-01-18T05:19:00Z] vervolgberichtSysteemprompt: huidige datum en tijd
De systeemprompt bevat een sectie Huidige datum en tijd met alleen de tijdzone (geen kloktijd of tijdnotatie), zodat promptcaching stabiel blijft:
Tijdzone: America/ChicagoDe zone is agents.defaults.userTimezone wanneer deze is geconfigureerd, anders de hosttijdzone.
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 envelopeTimezone-selectie als berichtomhulsels (standaard: hostlokaal).
Systeem: [2026-01-12 12:19:17 PST] Model gewijzigd.Tijdzone en notatie van 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", controleert OpenClaw de voorkeur van het besturingssysteem (macOS en Windows)
en valt het terug op de notatie van de landinstelling. 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: epoch-milliseconden (UTC)timestampUtc: ISO 8601 UTC-tekenreeks
Onbewerkte providervelden blijven behouden, zodat niets verloren gaat.
- Discord: UTC-tijdstempels in ISO-notatie
- Slack: epoch-achtige tekenreeksen van de API
- Telegram/WhatsApp: providerspecifieke numerieke/ISO-tijdstempels
Als je lokale tijd nodig hebt, converteer je deze verderop met behulp van de bekende tijdzone.
