Technical reference
Datum und Uhrzeit
OpenClaw verwendet hostlokale Zeit für Transport-Zeitstempel und fügt nur die Zeitzone in den System-Prompt ein.
Provider-Zeitstempel bleiben erhalten, damit Tools ihre nativen Semantiken beibehalten. Wenn der Agent die aktuelle
Uhrzeit benötigt, führt er das Tool session_status aus.
Nachrichtenumschläge (standardmäßig lokal)
Eingehende Nachrichten werden mit einem Wochentag und einem sekundengenauen Zeitstempel umschlossen:
[WhatsApp +1555 Mon 2026-01-05 16:26:34 PST] NachrichtentextDer Zeitstempel des Umschlags ist standardmäßig hostlokal, unabhängig von der Zeitzone des Providers.
Überschreiben Sie dies unter agents.defaults:
{ agents: { defaults: { envelopeTimezone: "local", // "utc" | "local" | "user" | IANA-Zeitzone envelopeTimestamp: "on", // "on" | "off" envelopeElapsed: "on", // "on" | "off" }, },}| Schlüssel | Werte | Verhalten |
|---|---|---|
envelopeTimezone |
local (Standard), utc, user, expliziter IANA-Name |
user verwendet agents.defaults.userTimezone (Host-Zeitzone, wenn nicht festgelegt). Ein expliziter IANA-Name (z. B. "America/Chicago") legt eine feste Zone fest; nicht erkannte Namen greifen auf UTC zurück. |
envelopeTimestamp |
on (Standard), off |
off entfernt absolute Zeitstempel aus Umschlagkopfzeilen, direkten Agent-Prompt-Präfixen und eingebetteten Modelleingabe-Präfixen. |
envelopeElapsed |
on (Standard), off |
off entfernt das Suffix für die verstrichene Zeit (im Stil von +30s / +2m), das die Zeit seit der vorherigen Nachricht in der Sitzung anzeigt. |
Beispiele
Lokal (Standard):
[WhatsApp +1555 Sun 2026-01-18 00:19:42 PST] HalloZeitzone des Benutzers:
[WhatsApp +1555 Sun 2026-01-18 00:19:42 CST] HalloVerstrichene Zeit mit envelopeTimezone: "utc":
[WhatsApp +1555 +30s Sun 2026-01-18T05:19:00Z] FolgenachrichtSystem-Prompt: aktuelles Datum und aktuelle Uhrzeit
Der System-Prompt enthält einen Abschnitt Aktuelles Datum und aktuelle Uhrzeit, der nur die Zeitzone enthält (keine Uhrzeit oder kein Zeitformat), damit das Prompt-Caching stabil bleibt:
Zeitzone: America/ChicagoDie Zone ist agents.defaults.userTimezone, wenn dies konfiguriert ist, andernfalls die Host-Zeitzone.
Der Prompt weist den Agenten außerdem an, das Tool session_status auszuführen, wenn er das
aktuelle Datum, die aktuelle Uhrzeit oder den Wochentag benötigt.
Systemereigniszeilen (standardmäßig lokal)
Systemereignisse in der Warteschlange, die in den Agentenkontext eingefügt werden, erhalten einen Zeitstempel als Präfix, der dieselbe
Auswahl envelopeTimezone wie Nachrichtenumschläge verwendet (Standard: hostlokal).
System: [2026-01-12 12:19:17 PST] Modell gewechselt.Zeitzone und Format des Benutzers konfigurieren
{ agents: { defaults: { userTimezone: "America/Chicago", timeFormat: "auto", // auto | 12 | 24 }, },}userTimezonelegt die benutzerlokale Zeitzone für den Prompt-Kontext (und fürenvelopeTimezone: "user") fest.timeFormatsteuert die 12-/24-Stunden-Anzeige in Prompt-bezogenen Zeitangaben.autofolgt den Betriebssystemeinstellungen.
Erkennung des Zeitformats (automatisch)
Bei timeFormat: "auto" prüft OpenClaw die Betriebssystemeinstellung (macOS und Windows)
und greift andernfalls auf die Gebietsschemaformatierung zurück. Der erkannte Wert wird prozessbezogen zwischengespeichert,
um wiederholte Systemaufrufe zu vermeiden.
Tool-Nutzdaten und Konnektoren (unverarbeitete Provider-Zeit und normalisierte Felder)
Kanal-Tools geben Provider-native Zeitstempel zurück und fügen zur Konsistenz normalisierte Felder hinzu:
timestampMs: Epochenzeit in Millisekunden (UTC)timestampUtc: UTC-Zeichenfolge im ISO-8601-Format
Unverarbeitete Provider-Felder bleiben erhalten, damit nichts verloren geht.
- Discord: UTC-Zeitstempel im ISO-Format
- Slack: epochenzeitähnliche Zeichenfolgen aus der API
- Telegram/WhatsApp: providerspezifische numerische/ISO-Zeitstempel
Wenn Sie lokale Zeit benötigen, konvertieren Sie sie nachgelagert mithilfe der bekannten Zeitzone.
