Concept internals
Часові пояси
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.
Налаштування часового поясу користувача
{ 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", коли часовий контекст не корисний для розмови. Це прибирає абсолютні часові позначки з конвертів, прямих префіксів промпта агента та вбудованих префіксів вводу моделі.
Повний довідник поведінки, приклади для кожного провайдера та форматування минулого часу див. у Дата й час.
Пов’язане
- Дата й час — повна поведінка конвертів/інструментів/промптів і приклади.
- Heartbeat — активні години використовують часовий пояс для планування.
- Завдання Cron — вирази cron використовують часовий пояс для планування.
