Перейти к основному содержимому

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

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

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). См. Дата и время для полного описания поведения и примеров.

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