> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  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](/de/date-time).

## Verwandt

* [Datum & Uhrzeit](/de/date-time) — vollständiges Verhalten und Beispiele für Nachrichtenhüllen, Tools und Prompts.
* [Heartbeat](/de/gateway/heartbeat) — aktive Stunden verwenden die Zeitzone für die Planung.
* [Cron-Jobs](/de/automation/cron-jobs) — Cron-Ausdrücke verwenden die Zeitzone für die Planung.