---
read_when:
    - Вы изменяете то, как временные метки показываются модели или пользователям
    - Вы отлаживаете форматирование времени в сообщениях или выводе системной подсказки
summary: Обработка даты и времени в конвертах, промптах, инструментах и коннекторах
title: Дата и время
x-i18n:
    generated_at: "2026-06-28T22:54:07Z"
    model: gpt-5.5
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: d40e8626269d26a14506a178080b353529080b6ee5ce523c3281521f1a34bf90
    source_path: date-time.md
    workflow: 16
---

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

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

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

```
[Provider ... Mon 2026-01-05 16:26:34 PST] message text
```

Эта временная метка конверта **по умолчанию использует локальное время хоста**, независимо от часового пояса провайдера.

Это поведение можно переопределить:

```json5
{
  agents: {
    defaults: {
      envelopeTimezone: "local", // "utc" | "local" | "user" | IANA timezone
      envelopeTimestamp: "on", // "on" | "off"
      envelopeElapsed: "on", // "on" | "off"
    },
  },
}
```

- `envelopeTimezone: "utc"` использует UTC.
- `envelopeTimezone: "local"` использует часовой пояс хоста.
- `envelopeTimezone: "user"` использует `agents.defaults.userTimezone` (при отсутствии значения используется часовой пояс хоста).
- Используйте явный часовой пояс IANA (например, `"America/Chicago"`) для фиксированной зоны.
- `envelopeTimestamp: "off"` удаляет абсолютные временные метки из заголовков конвертов, префиксов прямого промпта агента и встроенных префиксов входных данных модели.
- `envelopeElapsed: "off"` удаляет суффиксы прошедшего времени (стиль `+2m`).

### Примеры

**Локально (по умолчанию):**

```
[WhatsApp +1555 Sun 2026-01-18 00:19:42 PST] hello
```

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

```
[WhatsApp +1555 Sun 2026-01-18 00:19:42 CST] hello
```

**Прошедшее время включено:**

```
[WhatsApp +1555 +30s Sun 2026-01-18T05:19:00Z] follow-up
```

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

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

```
Time zone: America/Chicago
```

Когда агенту нужно текущее время, используйте инструмент `session_status`; карточка
статуса включает строку с временной меткой.

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

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

```
System: [2026-01-12 12:19:17 PST] Model switched.
```

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

```json5
{
  agents: {
    defaults: {
      userTimezone: "America/Chicago",
      timeFormat: "auto", // auto | 12 | 24
    },
  },
}
```

- `userTimezone` задает **локальный часовой пояс пользователя** для контекста промпта.
- `timeFormat` управляет **отображением 12/24 ч** в промпте. `auto` следует настройкам ОС.

## Обнаружение формата времени (auto)

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

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

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

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

Сырые поля провайдера сохраняются, чтобы ничего не потерялось.

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

Если нужно локальное время, преобразуйте его ниже по цепочке, используя известный часовой пояс.

## Связанные документы

- [Системный промпт](/ru/concepts/system-prompt)
- [Часовые пояса](/ru/concepts/timezone)
- [Сообщения](/ru/concepts/messages)