Datum und Uhrzeit in OpenClaw verwalten

Zeitstempel in verteilten Systemen können Kopfschmerzen bereiten. Wenn Nachrichten aus verschiedenen Zeitzonen eintreffen, verliert man schnell den Überblick darüber, was wann passiert ist. Oft ist unklar, ob ein Zeitstempel vom Provider, vom Server oder vom Nutzer stammt.

OpenClaw löst das, indem es standardmäßig die Zeit des Host-Systems für den Transport nutzt und die Zeitzone des Nutzers gezielt im System Prompt platziert. So bleibt der Kontext erhalten, ohne das Prompt Caching zu ruinieren.

Voraussetzungen

• Zugriff auf deine OpenClaw Konfigurationsdatei (JSON5)
• Ein Verständnis deiner Host-Umgebung (macOS, Windows oder Linux)

Schnellstart

In der Standardeinstellung nutzt OpenClaw die lokale Zeit deines Hosts. Um die Zeitzone für deine Agenten und das Zeitformat festzulegen, passt du die defaults an:

{
  agents: {
    defaults: {
      userTimezone: "America/Chicago",
      timeFormat: "auto", // auto | 12 | 24
    },
  },
}

Mit userTimezone definierst du den Standort des Nutzers für den Prompt-Kontext. timeFormat steuert die Anzeige (12h/24h). Bei auto erkennt OpenClaw die Betriebssystem-Einstellungen.

Message Envelopes und System-Events

Eingehende Nachrichten werden automatisch mit einem Zeitstempel versehen. Das sieht im Standard so aus:

[Provider ... 2026-01-05 16:26 PST] message text

Dieses Verhalten kannst du in der Konfiguration feinjustieren:

{
  agents: {
    defaults: {
      envelopeTimezone: "local", // "utc" | "local" | "user" | IANA timezone
      envelopeTimestamp: "on", // "on" | "off"
      envelopeElapsed: "on", // "on" | "off"
    },
  },
}

• envelopeTimezone: Wähle zwischen utc, local (Host), user (entspricht userTimezone) oder einer festen IANA-Zone wie "Europe/Berlin".
• envelopeTimestamp: Schaltet die absolute Uhrzeit im Header an oder aus.
• envelopeElapsed: Aktiviert oder deaktiviert Suffixe für vergangene Zeit (z. B. +2m).

Auch System-Events, die in den Kontext des Agenten eingereiht werden, nutzen diese Einstellungen: System: [2026-01-12 12:19:17 PST] Model switched.

System Prompt und Caching

Damit das Prompt Caching stabil bleibt, fügt OpenClaw im System Prompt nur die Zeitzone ein, keine tickende Uhr:

Time zone: America/Chicago

Wenn der Agent die exakte aktuelle Uhrzeit benötigt, nutzt er das session_status Tool. Die dortige Status-Card enthält eine aktuelle Zeitzeile.

Tool Payloads und Konnektoren

Channel Tools liefern die originalen Zeitstempel der Provider (Raw Data) und ergänzen normalisierte Felder für eine konsistente Verarbeitung:

• timestampMs: Epoch Millisekunden (UTC)
• timestampUtc: ISO 8601 UTC String

Unterschiedliche Provider liefern unterschiedliche Formate (Slack nutzt Epoch-Strings, Discord nutzt ISO-Zeitstempel). Durch die normalisierten Felder musst du dich nicht um diese Unterschiede kümmern. Falls du lokale Zeit benötigst, konvertiere diese Werte einfach mit der bekannten Zeitzone.

Fehlerbehebung

Das Zeitformat wird nicht korrekt erkannt Wenn timeFormat auf auto steht, prüft OpenClaw die OS-Einstellungen (macOS/Windows). Falls das fehlschlägt, wird auf das Locale-Formatting zurückgegriffen. Dieser Wert wird pro Prozess gecached, um unnötige Systemaufrufe zu vermeiden. Starte den Prozess neu, falls du OS-Einstellungen geändert hast.

AI Setup Assistant

Nächste Schritte

• System Prompt
• Timezones
• Messages