OpenClawDocs
На этой странице

На этой странице

View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Technical reference

Дата и время

OpenClaw использует локальное время хоста для временных меток транспорта и помещает в системный промпт только часовой пояс. Временные метки провайдера сохраняются, чтобы инструменты сохраняли свою исходную семантику. Когда агенту требуется текущее время, он запускает инструмент session_status.

Конверты сообщений (по умолчанию локальное время)

Входящие сообщения помещаются в конверт с днём недели и временной меткой с точностью до секунды:

Code
[WhatsApp +1555 Mon 2026-01-05 16:26:34 PST] текст сообщения

Временная метка конверта по умолчанию использует локальное время хоста, независимо от часового пояса провайдера. Переопределение настраивается в agents.defaults:

json5
{  agents: {    defaults: {      envelopeTimezone: "local", // "utc" | "local" | "user" | часовой пояс IANA      envelopeTimestamp: "on", // "on" | "off"      envelopeElapsed: "on", // "on" | "off"    },  },}
Ключ Значения Поведение
envelopeTimezone local (по умолчанию), utc, user, явное имя IANA user использует agents.defaults.userTimezone (часовой пояс хоста, если значение не задано). Явное имя IANA (например, "America/Chicago") закрепляет фиксированный часовой пояс; нераспознанные имена заменяются на UTC.
envelopeTimestamp on (по умолчанию), off off удаляет абсолютные временные метки из заголовков конвертов, непосредственных префиксов промпта агента и встроенных префиксов входных данных модели.
envelopeElapsed on (по умолчанию), off off удаляет суффикс прошедшего времени (в формате +30s / +2m), отображаемый с момента предыдущего сообщения в сеансе.

Примеры

Локальное время (по умолчанию):

Code
[WhatsApp +1555 Sun 2026-01-18 00:19:42 PST] привет

Часовой пояс пользователя:

Code
[WhatsApp +1555 Sun 2026-01-18 00:19:42 CST] привет

Прошедшее время с envelopeTimezone: "utc":

Code
[WhatsApp +1555 +30s Sun 2026-01-18T05:19:00Z] продолжение

Системный промпт: текущая дата и время

Системный промпт содержит раздел Текущая дата и время с только часовым поясом (без времени или формата времени), чтобы кэширование промпта оставалось стабильным:

Code
Часовой пояс: America/Chicago

Если настроен agents.defaults.userTimezone, используется этот часовой пояс, иначе — часовой пояс хоста. Промпт также предписывает агенту запускать инструмент session_status всякий раз, когда ему требуются текущая дата, время или день недели.

Строки системных событий (по умолчанию локальное время)

Системные события из очереди, вставляемые в контекст агента, получают префикс с временной меткой, использующий тот же выбор envelopeTimezone, что и конверты сообщений (по умолчанию — локальное время хоста).

Code
Система: [2026-01-12 12:19:17 PST] Модель переключена.

Настройка часового пояса пользователя и формата

json5
{  agents: {    defaults: {      userTimezone: "America/Chicago",      timeFormat: "auto", // auto | 12 | 24    },  },}
  • userTimezone задаёт локальный часовой пояс пользователя для контекста промпта (и для envelopeTimezone: "user").
  • timeFormat управляет 12-часовым/24-часовым отображением времени в промпте. auto следует настройкам ОС.

Определение формата времени (автоматически)

При timeFormat: "auto" OpenClaw проверяет настройки ОС (macOS и Windows), а при невозможности использует форматирование локали. Определённое значение кэшируется для каждого процесса, чтобы избежать повторных системных вызовов.

Полезные нагрузки инструментов и коннекторы (исходное время провайдера и нормализованные поля)

Инструменты каналов возвращают временные метки в исходном формате провайдера и для единообразия добавляют нормализованные поля:

  • timestampMs: миллисекунды с начала эпохи (UTC)
  • timestampUtc: строка UTC в формате ISO 8601

Исходные поля провайдера сохраняются, поэтому данные не теряются.

  • Discord: временные метки ISO в UTC
  • Slack: строки в формате, подобном времени эпохи, из API
  • Telegram/WhatsApp: числовые временные метки или временные метки ISO в формате провайдера

Если требуется локальное время, преобразуйте его на последующих этапах, используя известный часовой пояс.

Связанная документация

Was this useful?