Сообщения

Входящее сообщение
  -> маршрутизация/привязки -> ключ сеанса
  -> устранение дубликатов + задержка объединения
  -> очередь (если запуск уже активен)
  -> запуск агента (потоковая передача + инструменты)
  -> исходящие ответы (ограничения канала + разбиение на части)

• messages.* для префиксов, очередей, задержки объединения входящих сообщений и поведения в группах.
• agents.defaults.* для потоковой передачи блоков, разбиения на части и настроек тихих ответов по умолчанию.
• Переопределения каналов (channels.telegram.*, channels.whatsapp.* и т. д.) для ограничений и переключателей потоковой передачи отдельных каналов.

​

Устранение дубликатов входящих сообщений

​

Задержка объединения входящих сообщений

{
  messages: {
    inbound: {
      debounceMs: 2000,
      byChannel: {
        discord: 1500,
        slack: 1500,
        whatsapp: 5000,
      },
    },
  },
}

• Задержка объединения применяется только к текстовым сообщениям; мультимедиа и вложения немедленно сбрасывают накопленные сообщения.
• Управляющие команды (остановка/прерывание/состояние и т. д.) обходят задержку объединения и отправляются немедленно.
• По умолчанию отключено: у messages.inbound.debounceMs нет встроенного значения по умолчанию, поэтому задержка объединения активируется только после её настройки (глобально или для отдельного канала).
• Единственное исключение — включаемая настройка iMessage coalesceSameSenderDms: она достаточно долго удерживает весь текст личных сообщений от одного отправителя (включая команды), чтобы разделённая Apple отправка команды и URL поступила как один ход. Групповые чаты всегда обрабатываются немедленно независимо от этой настройки.

​

Сеансы и устройства

• Личные чаты объединяются под основным ключом сеанса агента.
• Группы и каналы получают собственные ключи сеансов.
• Хранилище сеансов и расшифровки находятся на хосте Gateway.

​

Содержимое запросов и контекст истории

• [Chat messages since your last reply - for context]
• [Current message - respond to this]

​

Метаданные результатов инструментов

• toolResult.details удаляется перед повторной передачей провайдеру и перед вводом для Compaction.
• В сохранённых расшифровках сеансов остаётся только ограниченный объём details; слишком большие метаданные заменяются компактной сводкой с отметкой persistedDetailsTruncated: true.
• Плагины и инструменты должны помещать текст, который обязана прочитать модель, в content, а не только в details.

​

Очереди и последующие сообщения

​

Владение запуском со стороны канала

​

Потоковая передача, разбиение и пакетная обработка

• agents.defaults.blockStreamingDefault (on|off, по умолчанию off)
• agents.defaults.blockStreamingBreak (text_end|message_end)
• agents.defaults.blockStreamingChunk (minChars|maxChars|breakPreference)
• agents.defaults.blockStreamingCoalesce (пакетная обработка на основе периода бездействия)
• agents.defaults.humanDelay (пауза, имитирующая человеческую, между ответами-блоками)
• Переопределения каналов: *.streaming.block.enabled и *.streaming.block.coalesce для встроенных каналов; устаревшие плоские ключи переносятся с помощью openclaw doctor --fix. Потоковая передача блоков отключена, если её явно не включить, во всех каналах, включая Telegram. Исключение — QQ Bot: у него нет ключей streaming.block, и он передаёт ответы-блоки потоком, если channels.qqbot.streaming.mode не имеет значения "off".

​

Видимость рассуждений и токены

• /reasoning on|off|stream управляет видимостью.
• Если модель создаёт содержимое рассуждений, оно всё равно учитывается при подсчёте использованных токенов.
• Telegram поддерживает потоковую передачу рассуждений во временный черновик сообщения, который удаляется после окончательной доставки; для постоянного вывода рассуждений используйте /reasoning on.

​

Префиксы, ветки и ответы

• Каскад исходящих префиксов: messages.responsePrefix, channels.<channel>.responsePrefix, channels.<channel>.accounts.<id>.responsePrefix. В WhatsApp также предусмотрен channels.whatsapp.messagePrefix для входящего префикса.
• Ответы в ветках через replyToMode и значения по умолчанию для отдельных каналов.

​

Тихие ответы

• Личные беседы никогда не получают инструкции запроса NO_REPLY. Если личный запуск случайно возвращает только тихий токен, OpenClaw подавляет его, а не переписывает и не доставляет.
• Группы и каналы по умолчанию допускают тишину. В режиме видимых ответов message_tool тишина означает, что модель не вызывает message(action=send).
• Внутренняя оркестрация по умолчанию допускает тишину.

​

Связанные разделы

• Рефакторинг жизненного цикла сообщений — целевая архитектура надёжной отправки и получения
• Потоковая передача — доставка сообщений в реальном времени
• Повторные попытки — поведение повторных попыток доставки сообщений
• Очередь — очередь обработки сообщений
• Каналы — интеграции с платформами обмена сообщениями