> ## 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.

# Часовые пояса

OpenClaw стандартизирует временные метки, чтобы модель видела **единое опорное время**, а не смесь локальных часов разных провайдеров. Часовые пояса отображаются на трех поверхностях, у каждой своя цель:

## Три поверхности часовых поясов

| Поверхность                    | Что она показывает                                                                                                               | По умолчанию                                     | Настраивается через                                                      |
| ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------ | ------------------------------------------------------------------------ |
| Оболочки сообщений             | Оборачивают входящие сообщения каналов: `[Signal +1555 Sun 2026-01-18 00:19:42 PST] hello`                                       | Локальный часовой пояс хоста                     | `agents.defaults.envelopeTimezone`                                       |
| Полезные нагрузки инструментов | Инструменты каналов в стиле `readMessages` возвращают исходное время провайдера + нормализованные `timestampMs` / `timestampUtc` | Поля UTC всегда присутствуют                     | Не настраивается — сохраняет временные метки в родном формате провайдера |
| Системный промпт               | Небольшой блок `Current Date & Time` с **только часовым поясом** (без значения времени, для стабильности кеша)                   | Часовой пояс хоста, если `userTimezone` не задан | `agents.defaults.userTimezone`                                           |

Системный промпт намеренно не включает текущее время, чтобы кеширование промптов оставалось стабильным между ходами. Когда агенту нужно текущее время, он вызывает `session_status`.

## Настройка часового пояса пользователя

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  agents: {
    defaults: {
      userTimezone: "America/Chicago",
    },
  },
}
```

Если `userTimezone` не задан, OpenClaw определяет часовой пояс хоста во время выполнения (без записи в конфигурацию). `agents.defaults.timeFormat` (`auto` | `12` | `24`) управляет отображением 12- или 24-часового формата в оболочках и последующих поверхностях, но не в разделе системного промпта.

## Когда переопределять

* **Используйте оболочки UTC** (`envelopeTimezone: "utc"`), если нужны стабильные временные метки на хостах в разных регионах или если нужно, чтобы журналы, выровненные по UTC, совпадали с диагностическим выводом.
* **Используйте фиксированную зону IANA** (например, `"Europe/Vienna"`), если хост Gateway находится в одном часовом поясе, а пользователь — в другом, и вы хотите, чтобы оболочки отображались в часовом поясе пользователя независимо от миграции хоста.
* **Задайте `envelopeTimestamp: "off"`**, если временной контекст не полезен для разговора. Это удаляет абсолютные временные метки из оболочек, префиксов прямых промптов агента и встроенных префиксов входных данных модели.

Полное справочное описание поведения, примеры по провайдерам и форматирование прошедшего времени см. в [Дата и время](/ru/date-time).

## Связанные материалы

* [Дата и время](/ru/date-time) — полное поведение оболочек, инструментов и промптов, а также примеры.
* [Heartbeat](/ru/gateway/heartbeat) — активные часы используют часовой пояс для планирования.
* [Задания Cron](/ru/automation/cron-jobs) — выражения cron используют часовой пояс для планирования.