Zum Hauptinhalt springen

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw standardisiert Zeitstempel, sodass das Modell eine einzige Referenzzeit statt einer Mischung aus Provider-lokalen Uhren sieht. Es gibt drei Oberflächen, auf denen Zeitzonen erscheinen, jeweils mit eigenem Zweck:

​
Drei Zeitzonen-Oberflächen

OberflächeWas sie zeigtStandardKonfiguriert über
Nachrichten-EnvelopesUmschließt eingehende Kanalnachrichten: [Signal +1555 2026-01-18 00:19 PST] helloHost-lokalagents.defaults.envelopeTimezone
Tool-PayloadsChannel-Tools im Stil von readMessages geben rohe Provider-Zeit + normalisierte timestampMs / timestampUtc zurückUTC-Felder immer vorhandenNicht konfigurierbar — erhält Provider-native Zeitstempel
System-PromptEin kleiner Current Date & Time-Block 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-Uhr 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 (kein Schreiben in die Konfiguration). agents.defaults.timeFormat (auto | 12 | 24) steuert die 12h-/24h-Darstellung in Envelopes und nachgelagerten Oberflächen, nicht im System-Prompt-Abschnitt.

​
Wann überschrieben werden sollte

  • Verwenden Sie UTC-Envelopes (envelopeTimezone: "utc"), wenn Sie stabile Zeitstempel über Hosts in verschiedenen Regionen hinweg wünschen oder wenn UTC-ausgerichtete Logs mit Diagnoseausgaben übereinstimmen 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 Envelopes unabhängig von einer Host-Migration in der Zeitzone des Benutzers gelesen werden.
  • Setzen Sie envelopeTimestamp: "off" für tokenarme Envelopes, wenn Zeitstempelkontext für die Unterhaltung nicht nützlich ist.
Die vollständige Verhaltensreferenz, Beispiele pro Provider und Formatierung verstrichener Zeit finden Sie unter Datum & Uhrzeit.

​
Verwandt

  • Datum & Uhrzeit — vollständiges Verhalten und Beispiele für Envelopes, Tools und Prompt.
  • Heartbeat — aktive Stunden verwenden die Zeitzone für die Planung.
  • Cron Jobs — Cron-Ausdrücke verwenden die Zeitzone für die Planung.