Concept internals
Zeitzonen
OpenClaw standardisiert Zeitstempel, sodass das Modell eine einzige Referenzzeit sieht statt einer Mischung aus Provider-lokalen Uhren. Es gibt drei Oberflächen, auf denen Zeitzonen erscheinen, jeweils mit eigenem Zweck:
Drei Zeitzonen-Oberflächen
| Oberfläche | Was sie zeigt | Standard | Konfiguriert über |
|---|---|---|---|
| Nachrichtenhüllen | Umschließt eingehende Kanalnachrichten: [Signal +1555 Sun 2026-01-18 00:19:42 PST] hello |
Host-lokal | agents.defaults.envelopeTimezone |
| Tool-Nutzdaten | Kanal-Tools im Stil von readMessages geben rohe Provider-Zeit + normalisiertes timestampMs / timestampUtc zurück |
UTC-Felder immer vorhanden | Nicht konfigurierbar — erhält Provider-native Zeitstempel |
| System-Prompt | Ein kleiner Block Current Date & Time mit nur der Zeitzone (kein Uhrzeitwert, für Cache-Stabilität) |
Host-Zeitzone, wenn userTimezone nicht gesetzt ist |
agents.defaults.userTimezone |
Der System-Prompt lässt die Live-Uhrzeit bewusst weg, um Prompt-Caching über Turns hinweg stabil zu halten. Wenn der Agent die aktuelle Uhrzeit benötigt, ruft er session_status auf.
Benutzerzeitzone festlegen
{ agents: { defaults: { userTimezone: "America/Chicago", }, },}Wenn userTimezone nicht gesetzt ist, löst OpenClaw die Host-Zeitzone zur Laufzeit auf (ohne Konfiguration zu schreiben). agents.defaults.timeFormat (auto | 12 | 24) steuert die 12h-/24h-Darstellung in Nachrichtenhüllen und nachgelagerten Oberflächen, nicht im System-Prompt-Abschnitt.
Wann überschrieben werden sollte
- Verwenden Sie UTC-Nachrichtenhüllen (
envelopeTimezone: "utc"), wenn Sie stabile Zeitstempel über Hosts in unterschiedlichen Regionen hinweg möchten oder wenn UTC-ausgerichtete Logs zur Diagnoseausgabe passen sollen. - Verwenden Sie eine feste IANA-Zone (z. B.
"Europe/Vienna"), wenn sich der Gateway-Host in einer Zone befindet, der Benutzer aber in einer anderen, und Sie möchten, dass Nachrichtenhüllen unabhängig von Host-Migrationen in der Zeitzone des Benutzers gelesen werden. - Setzen Sie
envelopeTimestamp: "off", wenn Zeitstempelkontext für die Unterhaltung nicht nützlich ist. Dadurch werden absolute Zeitstempel aus Nachrichtenhüllen, direkten Agent-Prompt-Präfixen und eingebetteten Modell-Eingabepräfixen entfernt.
Die vollständige Verhaltensreferenz, Beispiele pro Provider und die Formatierung verstrichener Zeit finden Sie unter Datum & Uhrzeit.
Verwandt
- Datum & Uhrzeit — vollständiges Verhalten und Beispiele für Nachrichtenhüllen, Tools und Prompts.
- Heartbeat — aktive Stunden verwenden die Zeitzone für die Planung.
- Cron-Jobs — Cron-Ausdrücke verwenden die Zeitzone für die Planung.
