Перейти до основного вмісту
OpenClaw за замовчуванням використовує локальний час хоста для часових міток транспорту і часовий пояс користувача лише в системному промпті. Часові мітки провайдера зберігаються, щоб інструменти зберігали свою нативну семантику (поточний час доступний через session_status).

​
Конверти повідомлень (локальні за замовчуванням)

Вхідні повідомлення обгортаються часовою міткою (точність до секунди): 
[Provider ... Mon 2026-01-05 16:26:34 PST] message text
Ця часова мітка конверта за замовчуванням є локальною для хоста, незалежно від часового поясу провайдера. Ви можете перевизначити цю поведінку: 
{
  agents: {
    defaults: {
      envelopeTimezone: "local", // "utc" | "local" | "user" | IANA timezone
      envelopeTimestamp: "on", // "on" | "off"
      envelopeElapsed: "on", // "on" | "off"
    },
  },
}
  • envelopeTimezone: "utc" використовує UTC.
  • envelopeTimezone: "local" використовує часовий пояс хоста.
  • envelopeTimezone: "user" використовує agents.defaults.userTimezone (із поверненням до часового поясу хоста).
  • Використовуйте явний часовий пояс IANA (наприклад, "America/Chicago") для фіксованої зони.
  • envelopeTimestamp: "off" вилучає абсолютні часові мітки із заголовків конвертів, префіксів прямого промпта агента та вбудованих префіксів вхідних даних моделі.
  • envelopeElapsed: "off" вилучає суфікси минулого часу (стиль +2m).

​
Приклади

Локальний (за замовчуванням): 
[WhatsApp +1555 Sun 2026-01-18 00:19:42 PST] hello
Часовий пояс користувача: 
[WhatsApp +1555 Sun 2026-01-18 00:19:42 CST] hello
Минулий час увімкнено: 
[WhatsApp +1555 +30s Sun 2026-01-18T05:19:00Z] follow-up

​
Системний промпт: поточна дата й час

Якщо часовий пояс користувача відомий, системний промпт містить окремий розділ Поточна дата й час із лише часовим поясом (без формату годинника/часу), щоб кешування промпта залишалося стабільним: 
Time zone: America/Chicago
Коли агенту потрібен поточний час, використовуйте інструмент session_status; картка статусу містить рядок із часовою міткою.

​
Рядки системних подій (локальні за замовчуванням)

Системні події в черзі, вставлені в контекст агента, мають префікс із часовою міткою, що використовує той самий вибір часового поясу, що й конверти повідомлень (за замовчуванням: локальний час хоста). 
System: [2026-01-12 12:19:17 PST] Model switched.

​
Налаштування часового поясу користувача й формату

{
  agents: {
    defaults: {
      userTimezone: "America/Chicago",
      timeFormat: "auto", // auto | 12 | 24
    },
  },
}
  • userTimezone задає локальний часовий пояс користувача для контексту промпта.
  • timeFormat керує відображенням у 12-годинному/24-годинному форматі в промпті. auto дотримується налаштувань ОС.

​
Визначення формату часу (auto)

Коли timeFormat: "auto", OpenClaw перевіряє налаштування ОС (macOS/Windows) і повертається до форматування локалі. Визначене значення кешується для кожного процесу, щоб уникнути повторних системних викликів.

​
Корисні навантаження інструментів + конектори (сирий час провайдера + нормалізовані поля)

Інструменти каналів повертають нативні часові мітки провайдера і додають нормалізовані поля для узгодженості:
  • timestampMs: мілісекунди епохи (UTC)
  • timestampUtc: рядок UTC у форматі ISO 8601
Сирі поля провайдера зберігаються, щоб нічого не втратити.
  • Slack: схожі на епоху рядки з API
  • Discord: часові мітки UTC ISO
  • Telegram/WhatsApp: числові/ISO часові мітки, специфічні для провайдера
Якщо вам потрібен локальний час, перетворіть його нижче за потоком, використовуючи відомий часовий пояс.

​
Пов’язані документи