---
read_when:
    - Вам потрібна швидка ментальна модель обробки часових поясів
    - Ви вирішуєте, де встановити або перевизначити часовий пояс
summary: Де часові пояси з’являються в OpenClaw — конверти, корисні навантаження інструментів, системний промпт
title: Часові пояси
x-i18n:
    generated_at: "2026-06-27T17:29:23Z"
    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 год у конвертах і downstream-поверхнях, але не в розділі системного промпта.

## Коли перевизначати

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