Перейти к основному содержанию
OpenClaw стандартизирует временные метки, чтобы модель видела единое опорное время, а не смесь локальных часов разных провайдеров. Часовые пояса отображаются на трех поверхностях, у каждой своя цель:

​
Три поверхности часовых поясов

ПоверхностьЧто она показываетПо умолчаниюНастраивается через
Оболочки сообщенийОборачивают входящие сообщения каналов: [Signal +1555 Sun 2026-01-18 00:19:42 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 используют часовой пояс для планирования.