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