diff --git a/docs/concepts/timezone.md b/docs/concepts/timezone.md index aea3ef39247..13426136e0e 100644 --- a/docs/concepts/timezone.md +++ b/docs/concepts/timezone.md @@ -12,7 +12,7 @@ OpenClaw standardizes timestamps so the model sees a **single reference time** i | Surface | What it shows | Default | Configured via | | ----------------- | ------------------------------------------------------------------------------------------------------- | ------------------------------------- | ------------------------------------------------------- | -| Message envelopes | Wraps inbound channel messages: `[Signal +1555 2026-01-18 00:19 PST] hello` | Host-local | `agents.defaults.envelopeTimezone` | +| Message envelopes | Wraps inbound channel messages: `[Signal +1555 Sun 2026-01-18 00:19:42 PST] hello` | Host-local | `agents.defaults.envelopeTimezone` | | Tool payloads | Channel `readMessages`-style tools return raw provider time + normalized `timestampMs` / `timestampUtc` | UTC fields always present | Not configurable — preserves provider-native timestamps | | System prompt | A small `Current Date & Time` block with the **time zone only** (no clock value, for cache stability) | Host timezone if `userTimezone` unset | `agents.defaults.userTimezone` | diff --git a/docs/date-time.md b/docs/date-time.md index d2014f04043..56f18203db8 100644 --- a/docs/date-time.md +++ b/docs/date-time.md @@ -11,10 +11,10 @@ Provider timestamps are preserved so tools keep their native semantics (current ## Message envelopes (local by default) -Inbound messages are wrapped with a timestamp (minute precision): +Inbound messages are wrapped with a timestamp (second precision): ``` -[Provider ... 2026-01-05 16:26 PST] message text +[Provider ... Mon 2026-01-05 16:26:34 PST] message text ``` This envelope timestamp is **host-local by default**, regardless of the provider timezone. @@ -45,19 +45,19 @@ You can override this behavior: **Local (default):** ``` -[WhatsApp +1555 2026-01-18 00:19 PST] hello +[WhatsApp +1555 Sun 2026-01-18 00:19:42 PST] hello ``` **User timezone:** ``` -[WhatsApp +1555 2026-01-18 00:19 CST] hello +[WhatsApp +1555 Sun 2026-01-18 00:19:42 CST] hello ``` **Elapsed time enabled:** ``` -[WhatsApp +1555 +30s 2026-01-18T05:19Z] follow-up +[WhatsApp +1555 +30s Sun 2026-01-18T05:19:00Z] follow-up ``` ## System prompt: current date and time