Дата й час

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 часові мітки, специфічні для провайдера

Якщо вам потрібен локальний час, перетворіть його нижче за потоком, використовуючи відомий часовий пояс.

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

• Системний промпт
• Часові пояси
• Повідомлення