---
read_when:
    - Вам нужна краткая мысленная модель обработки часовых поясов
    - Вы выбираете, где задать или переопределить часовой пояс
summary: Где часовые пояса появляются в OpenClaw — конверты, полезные нагрузки инструментов, системный промпт
title: Часовые пояса
x-i18n:
    generated_at: "2026-06-28T22:53:42Z"
    model: gpt-5.5
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: cc5bfe595c81b9c6ffaceac4c86b6f82b82917a506cdd7227e3e8cb1c0eb99a3
    source_path: concepts/timezone.md
    workflow: 16
---

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
{
  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 используют часовой пояс для планирования.