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 gebruikt standaard host-lokale tijd voor transporttijdstempels en de gebruikerstijdzone alleen in de systeemprompt. Providertijdstempels blijven behouden, zodat tools hun eigen semantiek behouden (de huidige tijd is beschikbaar via session_status).

​
Bericht-enveloppen (standaard lokaal)

Binnenkomende berichten worden verpakt met een tijdstempel (precisie tot op de minuut): 
[Provider ... 2026-01-05 16:26 PST] message text
Deze enveloptijdstempel is standaard host-lokaal, ongeacht de tijdzone van de provider. Je kunt dit gedrag overschrijven: 
{
  agents: {
    defaults: {
      envelopeTimezone: "local", // "utc" | "local" | "user" | IANA timezone
      envelopeTimestamp: "on", // "on" | "off"
      envelopeElapsed: "on", // "on" | "off"
    },
  },
}
  • envelopeTimezone: "utc" gebruikt UTC.
  • envelopeTimezone: "local" gebruikt de tijdzone van de host.
  • envelopeTimezone: "user" gebruikt agents.defaults.userTimezone (valt terug op de tijdzone van de host).
  • Gebruik een expliciete IANA-tijdzone (bijv. "America/Chicago") voor een vaste zone.
  • envelopeTimestamp: "off" verwijdert absolute tijdstempels uit envelopheaders.
  • envelopeElapsed: "off" verwijdert achtervoegsels voor verstreken tijd (de +2m-stijl).

​
Voorbeelden

Lokaal (standaard): 
[WhatsApp +1555 2026-01-18 00:19 PST] hello
Gebruikerstijdzone: 
[WhatsApp +1555 2026-01-18 00:19 CST] hello
Verstreken tijd ingeschakeld: 
[WhatsApp +1555 +30s 2026-01-18T05:19Z] follow-up

​
Systeemprompt: huidige datum en tijd

Als de gebruikerstijdzone bekend is, bevat de systeemprompt een aparte sectie Huidige datum en tijd met alleen de tijdzone (geen klok-/tijdnotatie) om promptcaching stabiel te houden: 
Time zone: America/Chicago
Wanneer de agent de huidige tijd nodig heeft, gebruik je de tool session_status; de statuskaart bevat een regel met een tijdstempel.

​
Systeemgebeurtenisregels (standaard lokaal)

Systeemgebeurtenissen in de wachtrij die in de agentcontext worden ingevoegd, krijgen een voorvoegsel met een tijdstempel op basis van dezelfde tijdzoneselectie als bericht-enveloppen (standaard: host-lokaal). 
System: [2026-01-12 12:19:17 PST] Model switched.

​
Gebruikerstijdzone + notatie configureren

{
  agents: {
    defaults: {
      userTimezone: "America/Chicago",
      timeFormat: "auto", // auto | 12 | 24
    },
  },
}
  • userTimezone stelt de gebruikerslokale tijdzone in voor promptcontext.
  • timeFormat bepaalt de 12u/24u-weergave in de prompt. auto volgt OS-voorkeuren.

​
Tijdnotatiedetectie (auto)

Wanneer timeFormat: "auto" is ingesteld, inspecteert OpenClaw de OS-voorkeur (macOS/Windows) en valt terug op locale-opmaak. De gedetecteerde waarde wordt per proces gecachet om herhaalde systeemaanroepen te vermijden.

​
Tool-payloads + connectors (ruwe providertijd + genormaliseerde velden)

Channel-tools retourneren provider-native tijdstempels en voegen genormaliseerde velden toe voor consistentie:
  • timestampMs: epoch-milliseconden (UTC)
  • timestampUtc: ISO 8601 UTC-string
Ruwe providervelden blijven behouden, zodat er niets verloren gaat.
  • Slack: epoch-achtige strings van de API
  • Discord: UTC ISO-tijdstempels
  • Telegram/WhatsApp: providerspecifieke numerieke/ISO-tijdstempels
Als je lokale tijd nodig hebt, converteer die dan downstream met de bekende tijdzone.

​
Gerelateerde docs