Внутренние концепции

Часовые пояса

OpenClaw стандартизирует временные метки, чтобы модель видела единое эталонное время.

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

Входящие сообщения оборачиваются в конверт, например:

[Provider ... 2026-01-05 16:26 PST] текст сообщения

Временная метка в конверте по умолчанию локальная для хоста, с точностью до минут. Это можно переопределить:

{
  agents: {
    defaults: {
      envelopeTimezone: "local", // "utc" | "local" | "user" | IANA часовой пояс
      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] привет

Фиксированный часовой пояс:

[Signal Alice +1555 2026-01-18 06:19 GMT+1] привет

Прошедшее время:

[Signal Alice +1555 +2m 2026-01-18T05:19Z] продолжение

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

Вызовы инструментов (channels.discord.readMessages, channels.slack.readMessages и т.д.) возвращают сырые временные метки провайдера. Мы также добавляем нормализованные поля для согласованности:

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

Сырые поля провайдера сохраняются.

Часовой пояс пользователя для системного промпта

Установите agents.defaults.userTimezone, чтобы сообщить модели локальный часовой пояс пользователя. Если он не задан, OpenClaw определяет часовой пояс хоста во время выполнения (без записи в конфигурацию).

{
  agents: { defaults: { userTimezone: "America/Chicago" } },
}

Системный промпт включает:

  • Раздел Текущая дата и время с локальным временем и часовым поясом
  • Формат времени: 12-часовой или 24-часовой

Вы можете управлять форматом промпта с помощью agents.defaults.timeFormat (auto | 12 | 24). См. Дата и время для полного описания поведения и примеров.

Отслеживание использованияКредиты