Часові пояси

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.

# Налаштування часового поясу користувача

{
  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" для конвертів із малою кількістю токенів, коли часовий контекст не корисний для розмови.

Повну довідку про поведінку, приклади для кожного провайдера та форматування минулого часу див. у Дата й час.

# Пов’язане

• Дата й час — повна поведінка конвертів, інструментів і промпта, а також приклади.
• Heartbeat — активні години використовують часовий пояс для планування.
• Завдання Cron — вирази cron використовують часовий пояс для планування.