---
read_when:
    - Вам потрібна коротка ментальна модель для роботи з часовими поясами
    - Ви вирішуєте, де встановити або перевизначити часовий пояс
summary: Де часові пояси з’являються в OpenClaw — конверти, корисні навантаження інструментів, системний промпт
title: Часові пояси
x-i18n:
    generated_at: "2026-05-05T16:51:45Z"
    model: gpt-5.5
    provider: openai
    source_hash: 041b207a0fa2758a20e8f3c4eca852d3dd416560d045459cb4d86709b45449e3
    source_path: concepts/timezone.md
    workflow: 16
---

OpenClaw стандартизує часові позначки, щоб модель бачила **єдиний опорний час** замість суміші локальних годинників провайдерів. Є три поверхні, де з’являються часові пояси, і кожна має своє призначення:

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

| Поверхня          | Що вона показує                                                                                         | Типово                                | Налаштовується через                                   |
| ----------------- | ------------------------------------------------------------------------------------------------------- | ------------------------------------- | ------------------------------------------------------ |
| Конверти повідомлень | Обгортає вхідні повідомлення каналів: `[Signal +1555 2026-01-18 00:19 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"`** для конвертів із малою кількістю токенів, коли часовий контекст не корисний для розмови.

Повну довідку про поведінку, приклади для кожного провайдера та форматування минулого часу див. у [Дата й час](/uk/date-time).

## Пов’язане

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