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

​
Часові пояси

OpenClaw стандартизує часові позначки, щоб модель бачила єдиний опорний час.

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

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

​
Приклади

Локальний (типово): 
[Signal Alice +1555 2026-01-18 00:19 PST] hello
Фіксований часовий пояс: 
[Signal Alice +1555 2026-01-18 06:19 GMT+1] hello
Відносний час: 
[Signal Alice +1555 +2m 2026-01-18T05:19Z] follow-up

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

Виклики інструментів (channels.discord.readMessages, channels.slack.readMessages тощо) повертають сирі часові позначки провайдера. Ми також додаємо нормалізовані поля для узгодженості:
  • timestampMs (мілісекунди епохи UTC)
  • timestampUtc (рядок UTC у форматі ISO 8601)
Сирі поля провайдера зберігаються.

​
Часовий пояс користувача для системного prompt

Установіть agents.defaults.userTimezone, щоб повідомити моделі локальний часовий пояс користувача. Якщо він не заданий, OpenClaw визначає часовий пояс хоста під час виконання (без запису в конфігурацію). 
{
  agents: { defaults: { userTimezone: "America/Chicago" } },
}
Системний prompt містить:
  • розділ Current Date & Time з локальним часом і часовим поясом
  • Time format: 12-hour або 24-hour
Ви можете керувати форматом prompt через agents.defaults.timeFormat (auto | 12 | 24). Повну поведінку та приклади див. у Date & Time.

​
Пов’язане

  • Heartbeat — активні години використовують часовий пояс для планування
  • Cron Jobs — cron-вирази використовують часовий пояс для планування
  • Date & Time — повна поведінка дати/часу та приклади