Перейти до основного вмісту

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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