Три поверхні часових поясів
| Поверхня | Що вона показує | Типове значення | Налаштовується через |
|---|---|---|---|
| Конверти повідомлень | Обгортає вхідні повідомлення каналів: [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.
Налаштування часового поясу користувача
userTimezone не задано, OpenClaw визначає часовий пояс хоста під час виконання (без запису конфігурації). agents.defaults.timeFormat (auto | 12 | 24) керує відображенням у форматі 12/24 год у конвертах і downstream-поверхнях, але не в розділі системного промпта.
Коли перевизначати
- Використовуйте конверти UTC (
envelopeTimezone: "utc"), коли потрібні стабільні часові позначки на хостах у різних регіонах або коли потрібно, щоб журнали, вирівняні за UTC, відповідали діагностичному виводу. - Використовуйте фіксовану зону IANA (наприклад,
"Europe/Vienna"), коли хост Gateway перебуває в одному часовому поясі, а користувач — в іншому, і ви хочете, щоб конверти читалися в часовому поясі користувача незалежно від міграції хоста. - Установіть
envelopeTimestamp: "off", коли часовий контекст не корисний для розмови. Це прибирає абсолютні часові позначки з конвертів, прямих префіксів промпта агента та вбудованих префіксів вводу моделі.
Пов’язане
- Дата й час — повна поведінка конвертів/інструментів/промптів і приклади.
- Heartbeat — активні години використовують часовий пояс для планування.
- Завдання Cron — вирази cron використовують часовий пояс для планування.