Zum Hauptinhalt springen
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ächeWas sie zeigtStandardKonfiguriert über
NachrichtenhüllenUmschließt eingehende Kanalnachrichten: [Signal +1555 Sun 2026-01-18 00:19:42 PST] helloHost-lokalagents.defaults.envelopeTimezone
Tool-NutzdatenKanal-Tools im Stil von readMessages geben rohe Provider-Zeit + normalisiertes timestampMs / timestampUtc zurückUTC-Felder immer vorhandenNicht konfigurierbar — erhält Provider-native Zeitstempel
System-PromptEin kleiner Block Current Date & Time mit nur der Zeitzone (kein Uhrzeitwert, für Cache-Stabilität)Host-Zeitzone, wenn userTimezone nicht gesetzt istagents.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.