OpenClaw Zeitzonen konfigurieren: Zeitstempel präzise steuer

Jeder Entwickler kennt das Problem: Zeitzonen sind anstrengend. Wenn du mit KI-Modellen arbeitest, wird es noch komplizierter, da das Modell einen klaren zeitlichen Bezugsrahmen braucht, um Nachrichten richtig einzuordnen. Ohne eine saubere Standardisierung weiß die KI oft nicht, ob “heute Morgen” vor zwei Stunden oder in einer ganz anderen Zeitzone war.

OpenClaw löst das, indem es Zeitstempel standardisiert, damit das Modell eine einheitliche Referenzzeit sieht.

Nachrichten-Envelopes (standardmäßig lokal)

Eingehende Nachrichten werden in einen Envelope (Umschlag) gepackt, der so aussieht:

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

Der Zeitstempel im Envelope ist standardmäßig host-lokal und auf Minuten genau.

Du kannst dies mit folgender Konfiguration überschreiben:

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

• envelopeTimezone: "utc" verwendet UTC.
• envelopeTimezone: "user" verwendet agents.defaults.userTimezone (fällt auf die Host-Zeitzone zurück, falls nicht gesetzt).
• Verwende eine explizite IANA-Zeitzone (z. B. "Europe/Vienna") für einen festen Offset.
• envelopeTimestamp: "off" entfernt absolute Zeitstempel aus den Envelope-Headern.
• envelopeElapsed: "off" entfernt die Suffixe für die verstrichene Zeit (den +2m Stil).

Beispiele

Lokal (Standard):

[Signal Alice +1555 2026-01-18 00:19 PST] hello

Feste Zeitzone:

[Signal Alice +1555 2026-01-18 06:19 GMT+1] hello

Verstrichene Zeit:

[Signal Alice +1555 +2m 2026-01-18T05:19Z] follow-up

Tool-Payloads (Rohdaten der Provider + normalisierte Felder)

Tool-Aufrufe (channels.discord.readMessages, channels.slack.readMessages usw.) geben die ursprünglichen Zeitstempel der Provider zurück. Zusätzlich fügen wir normalisierte Felder für die Konsistenz hinzu:

• timestampMs (UTC-Epochen-Millisekunden)
• timestampUtc (ISO 8601 UTC-String)

Die ursprünglichen Felder des Providers bleiben erhalten.

Benutzer-Zeitzone für den System-Prompt

Setze agents.defaults.userTimezone, um dem Modell die lokale Zeitzone des Benutzers mitzuteilen. Wenn dieser Wert nicht gesetzt ist, ermittelt OpenClaw die Host-Zeitzone zur Laufzeit (ohne die Konfiguration zu schreiben).

{
  agents: { defaults: { userTimezone: "America/Chicago" } },
}

Der System-Prompt enthält:

• Einen Current Date & Time Abschnitt mit lokaler Zeit und Zeitzone
• Das Zeitformat: Time format: 12-hour oder 24-hour

Du kannst das Format des Prompts mit agents.defaults.timeFormat steuern (auto | 12 | 24).

Schau dir Date & Time an, um das vollständige Verhalten und weitere Beispiele zu sehen.

Verwandte Themen

• Heartbeat — Aktive Stunden nutzen die Zeitzone für das Scheduling
• Cron Jobs — Cron-Ausdrücke nutzen die Zeitzone für das Scheduling
• Date & Time — Vollständiges Datum/Zeit-Verhalten und Beispiele

Nächste Schritte

• Erfahre mehr über Automatisierung
• Optimiere dein Gateway Setup

AI Setup Assistant