Technical reference
Datum und Uhrzeit
OpenClaw verwendet die lokale Zeit des Hosts für Transport-Zeitstempel und nimmt nur die Zeitzone in den System-Prompt auf.
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 lokal zum Host, 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 (Zeitzone des Hosts, wenn nicht festgelegt). Ein expliziter IANA-Name (z. B. "America/Chicago") legt eine feste Zone fest; unbekannte Namen fallen auf UTC zurück. |
envelopeTimestamp |
on (Standard), off |
off entfernt absolute Zeitstempel aus Umschlag-Kopfzeilen, direkten Präfixen des Agenten-Prompts und eingebetteten Präfixen der Modelleingabe. |
envelopeElapsed |
on (Standard), off |
off entfernt das seit der vorherigen Nachricht in der Sitzung angezeigte Suffix für die verstrichene Zeit (im Format +30s / +2m). |
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 und kein Zeitformat), damit das Prompt-Caching stabil bleibt:
Zeitzone: America/ChicagoDie Zone entspricht agents.defaults.userTimezone, wenn dies konfiguriert ist, andernfalls der Zeitzone des Hosts.
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 als Präfix einen Zeitstempel mit derselben
envelopeTimezone-Auswahl wie Nachrichtenumschläge (Standard: lokal zum Host).
System: [2026-01-12 12:19:17 PST] Modell gewechselt.Zeitzone des Benutzers und Format konfigurieren
{ agents: { defaults: { userTimezone: "America/Chicago", timeFormat: "auto", // auto | 12 | 24 }, },}userTimezonelegt die lokale Zeitzone des Benutzers für den Prompt-Kontext fest (und fürenvelopeTimezone: "user").timeFormatsteuert die 12-/24-Stunden-Anzeige für Uhrzeiten in Prompts.autofolgt den Einstellungen des Betriebssystems.
Erkennung des Zeitformats (automatisch)
Wenn timeFormat: "auto" festgelegt ist, prüft OpenClaw die Betriebssystemeinstellung (macOS und Windows)
und greift andernfalls auf die Formatierung des Gebietsschemas zurück. Der erkannte Wert wird prozessbezogen zwischengespeichert,
um wiederholte Systemaufrufe zu vermeiden.
Tool-Nutzdaten und Konnektoren (unveränderte Provider-Zeit und normalisierte Felder)
Kanal-Tools geben Provider-native Zeitstempel zurück und fügen zur Vereinheitlichung normalisierte Felder hinzu:
timestampMs: Epochenzeit in Millisekunden (UTC)timestampUtc: UTC-Zeichenfolge nach ISO 8601
Die unveränderten Provider-Felder bleiben erhalten, damit keine Informationen verloren gehen.
- Discord: UTC-Zeitstempel nach ISO
- Slack: epochenähnliche Zeichenfolgen aus der API
- Telegram/WhatsApp: Provider-spezifische numerische Zeitstempel oder ISO-Zeitstempel
Wenn Sie die lokale Zeit benötigen, konvertieren Sie sie nachgelagert mithilfe der bekannten Zeitzone.
