Группы

OpenClaw обрабатывает групповые чаты согласованно на разных поверхностях: Discord, iMessage, Matrix, Microsoft Teams, QQBot, Signal, Slack, Telegram, WhatsApp, Zalo.

Для постоянно включенных комнат, которые должны предоставлять тихий контекст, если агент явно не отправляет видимое сообщение, см. Фоновые события комнат.

Введение для начинающих (2 минуты)

OpenClaw «живет» в ваших собственных учетных записях мессенджеров. Отдельного пользователя-бота WhatsApp нет. Если вы состоите в группе, OpenClaw может видеть эту группу и отвечать в ней.

Поведение по умолчанию:

• Группы ограничены (groupPolicy: "allowlist").
• Для ответов требуется упоминание, если вы явно не отключите шлюзование по упоминаниям.
• Видимые ответы в группах/каналах по умолчанию используют инструмент message.

Перевод: отправители из списка разрешенных могут запускать OpenClaw, упоминая его.

Быстрый поток (что происходит с групповым сообщением):

groupPolicy? disabled -> dropgroupPolicy? allowlist -> group allowed? no -> droprequireMention? yes -> mentioned? no -> store for context onlymention/reply/command/DM -> user requestalways-on group chatter -> user request, or room event when configured

Видимые ответы

Для обычных групповых/канальных запросов OpenClaw по умолчанию использует messages.groupChat.visibleReplies: "automatic". Итоговый текст ассистента публикуется через устаревший путь видимого ответа, если вы не включите для комнаты вывод только через инструмент сообщений.

Используйте messages.groupChat.visibleReplies: "message_tool", когда в общей комнате агент должен сам решать, когда говорить, вызывая message(action=send). Это лучше всего работает для групповых комнат на базе моделей последнего поколения с надежной работой инструментов, таких как GPT 5.5. Если модель пропустит этот инструмент и вернет содержательный итоговый текст, OpenClaw сохранит этот итоговый текст приватным вместо публикации в комнату.

Используйте "automatic" для более слабых моделей или сред выполнения, которые ненадежно понимают доставку только через инструмент. В автоматическом режиме итоговый текст ассистента является видимым исходным путем ответа, поэтому модель, которая не может стабильно вызывать message(action=send), все равно может отвечать обычным образом.

В автоматическом режиме обычные итоговые текстовые ответы публикуются напрямую в комнату. Если видимому ответу нужны файлы, изображения или другие вложения, агент все еще может использовать message(action=send) для такого вложения вместо попытки протолкнуть его через итоговый текстовый ответ.

Если инструмент сообщений недоступен по активной политике инструментов, OpenClaw откатывается к автоматическим видимым ответам вместо молчаливого подавления ответа. openclaw doctor предупреждает об этом несоответствии.

Для прямых чатов и любого другого исходного события используйте messages.visibleReplies: "message_tool", чтобы глобально применить такое же поведение видимых ответов только через инструмент. Прямые ходы внутреннего WebChat по умолчанию используют автоматическую доставку итогового ответа, чтобы Pi и Codex получали один и тот же контракт видимого ответа. Задайте messages.visibleReplies: "message_tool", чтобы намеренно требовать message(action=send) для видимого вывода. messages.groupChat.visibleReplies остается более специфичным переопределением для групповых/канальных комнат.

Это заменяет старый шаблон принуждения модели отвечать NO_REPLY для большинства ходов в режиме наблюдения. В режиме только через инструмент промпт не определяет контракт NO_REPLY. Отсутствие видимых действий просто означает, что инструмент сообщений не вызывается.

Привязки разговоров, принадлежащие Plugin, являются исключением. Когда Plugin привязывает тред и забирает входящий ход, ответ, возвращенный Plugin, является видимым ответом привязки; ему не нужен message(action=send). Этот ответ является выводом среды выполнения Plugin, а не приватным итоговым текстом модели.

Индикаторы набора текста все еще отправляются для прямых групповых запросов. Фоновые постоянно включенные события комнат, если они включены, остаются строгими и тихими, если агент не вызывает инструмент сообщений.

Сеансы по умолчанию подавляют подробные сводки инструментов/прогресса. Используйте /verbose on, чтобы показывать эти сводки для текущего сеанса при отладке, и /verbose off, чтобы вернуться к поведению только с итоговыми ответами. То же состояние подробного режима применяется в прямых чатах, группах, каналах и темах форумов.

Чтобы отправлять неупомянутую болтовню в постоянно включенной группе как тихий контекст комнаты вместо пользовательских запросов, используйте Фоновые события комнат:

{  messages: {    groupChat: {      unmentionedInbound: "room_event",    },  },}

По умолчанию используется unmentionedInbound: "user_request".

Упомянутые сообщения, команды, запросы прерывания и личные сообщения остаются пользовательскими запросами.

Чтобы потребовать прохождения видимого вывода через инструмент сообщений для групповых/канальных запросов:

{  messages: {    groupChat: {      visibleReplies: "message_tool",    },  },}

Gateway выполняет горячую перезагрузку конфигурации messages после сохранения файла. Перезапуск нужен только когда наблюдение за файлами или перезагрузка конфигурации отключены в развертывании.

Чтобы потребовать прохождения видимого вывода через инструмент сообщений для каждого исходного чата:

{  messages: {    visibleReplies: "message_tool",  },}

Нативные слэш-команды (Discord, Telegram и другие поверхности с поддержкой нативных команд) обходят visibleReplies: "message_tool" и всегда отвечают видимо, чтобы нативный для канала командный UI получил ожидаемый ответ. Это применяется только к проверенным нативным командным ходам; текстовые команды /... и обычные ходы чата по-прежнему следуют настроенному групповому значению по умолчанию.

Видимость контекста и списки разрешенных

В безопасности групп задействованы два разных механизма управления:

• Авторизация запуска: кто может запускать агента (groupPolicy, groups, groupAllowFrom, списки разрешенных, специфичные для канала).
• Видимость контекста: какой дополнительный контекст внедряется в модель (текст ответа, цитаты, история треда, пересланные метаданные).

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

Если вы хотите...

Для переиспользуемых списков разрешенных отправителей см. Группы доступа.

Ключи сеансов

• Групповые сеансы используют ключи сеансов agent:<agentId>:<channel>:group:<id> (комнаты/каналы используют agent:<agentId>:<channel>:channel:<id>).
• Темы форумов Telegram добавляют :topic:<threadId> к идентификатору группы, чтобы у каждой темы был собственный сеанс.
• Прямые чаты используют основной сеанс (или отдельный по отправителю, если настроено).
• Heartbeat пропускаются для групповых сеансов.

Шаблон: личные сообщения + публичные группы (один агент)

Да — это хорошо работает, если ваш «личный» трафик — это личные сообщения, а ваш «публичный» трафик — это группы.

Почему: в режиме одного агента личные сообщения обычно попадают в основной ключ сеанса (agent:main:main), тогда как группы всегда используют неосновные ключи сеансов (agent:main:<channel>:group:<id>). Если вы включите изоляцию с mode: "non-main", эти групповые сеансы будут работать в настроенном backend изоляции, а ваш основной сеанс личных сообщений останется на хосте. Docker является backend по умолчанию, если вы не выберете другой.

Это дает вам один «мозг» агента (общая рабочая область + память), но две позиции выполнения:

• Личные сообщения: полные инструменты (хост)
• Группы: изоляция + ограниченные инструменты

{  agents: {    defaults: {      sandbox: {        mode: "non-main", // groups/channels are non-main -> sandboxed        scope: "session", // strongest isolation (one container per group/channel)        workspaceAccess: "none",      },    },  },  tools: {    sandbox: {      tools: {        // If allow is non-empty, everything else is blocked (deny still wins).        allow: ["group:messaging", "group:sessions"],        deny: ["group:runtime", "group:fs", "group:ui", "nodes", "cron", "gateway"],      },    },  },}

{  agents: {    defaults: {      sandbox: {        mode: "non-main",        scope: "session",        workspaceAccess: "none",        docker: {          binds: [            // hostPath:containerPath:mode            "/home/user/FriendsShared:/data:ro",          ],        },      },    },  },}

Связано:

• Ключи конфигурации и значения по умолчанию: Конфигурация Gateway
• Отладка того, почему инструмент заблокирован: Изоляция vs политика инструментов vs повышенные права
• Подробности bind mounts: Изоляция

Отображаемые метки

• Метки UI используют displayName, когда доступно, в формате <channel>:<token>.
• #room зарезервировано для комнат/каналов; групповые чаты используют g-<slug> (нижний регистр, пробелы -> -, сохранять #@+._-).

Политика групп

Управляйте обработкой сообщений групп/комнат для каждого канала:

{  channels: {    whatsapp: {      groupPolicy: "disabled", // "open" | "disabled" | "allowlist"      groupAllowFrom: ["+15551234567"],    },    telegram: {      groupPolicy: "disabled",      groupAllowFrom: ["123456789"], // числовой идентификатор пользователя Telegram (мастер может разрешить @username)    },    signal: {      groupPolicy: "disabled",      groupAllowFrom: ["+15551234567"],    },    imessage: {      groupPolicy: "disabled",      groupAllowFrom: ["chat_id:123"],    },    msteams: {      groupPolicy: "disabled",      groupAllowFrom: ["user@org.com"],    },    discord: {      groupPolicy: "allowlist",      guilds: {        GUILD_ID: { channels: { help: { allow: true } } },      },    },    slack: {      groupPolicy: "allowlist",      channels: { "#general": { allow: true } },    },    matrix: {      groupPolicy: "allowlist",      groupAllowFrom: ["@owner:example.org"],      groups: {        "!roomId:example.org": { enabled: true },        "#alias:example.org": { enabled: true },      },    },  },}

Краткая ментальная модель (порядок оценки групповых сообщений):

Фильтр упоминаний (по умолчанию)

Групповые сообщения требуют упоминания, если это не переопределено для отдельной группы. Значения по умолчанию находятся для каждой подсистемы в *.groups."*".

Ответ на сообщение бота считается неявным упоминанием, когда канал поддерживает метаданные ответа. Цитирование сообщения бота также может считаться неявным упоминанием в каналах, которые предоставляют метаданные цитаты. Текущие встроенные случаи включают Telegram, WhatsApp, Slack, Discord, Microsoft Teams и ZaloUser.

{  channels: {    whatsapp: {      groups: {        "*": { requireMention: true },        "123@g.us": { requireMention: false },      },    },    telegram: {      groups: {        "*": { requireMention: true },        "123456789": { requireMention: false },      },    },    imessage: {      groups: {        "*": { requireMention: true },        "123": { requireMention: false },      },    },  },  agents: {    list: [      {        id: "main",        groupChat: {          mentionPatterns: ["@openclaw", "openclaw", "\\+15555550123"],          historyLimit: 50,        },      },    ],  },}

Область действия настроенных шаблонов упоминаний

Настроенные mentionPatterns — это резервные триггеры regex. Используйте их, когда платформа не предоставляет нативное упоминание бота или когда вы хотите, чтобы обычный текст, например openclaw:, считался упоминанием. Нативные упоминания платформы отделены: когда Discord, Slack, Telegram, Matrix или другой канал может доказать, что сообщение явно упомянуло бота, это нативное упоминание всё равно срабатывает, даже если настроенные regex-шаблоны запрещены.

По умолчанию настроенные шаблоны упоминаний применяются везде, где этот канал передаёт факты о провайдере и беседе в обнаружение упоминаний. Чтобы широкие шаблоны не пробуждали агента в каждой группе, ограничьте их область действия по каналу с помощью channels.<channel>.mentionPatterns.

Используйте mode: "deny", когда regex-шаблоны упоминаний должны быть выключены по умолчанию для канала, а затем включайте отдельные комнаты через allowIn:

{  messages: {    groupChat: {      mentionPatterns: ["\\bopenclaw\\b", "\\bops bot\\b"],    },  },  channels: {    slack: {      mentionPatterns: {        mode: "deny",        allowIn: ["C0123OPS"],      },    },  },}

Используйте значение по умолчанию mode: "allow" (или опустите mode), когда regex-шаблоны упоминаний должны применяться широко, а затем отключайте их в шумных комнатах с помощью denyIn:

{  messages: {    groupChat: {      mentionPatterns: ["\\bopenclaw\\b"],    },  },  channels: {    telegram: {      mentionPatterns: {        denyIn: ["-1001234567890", "-1001234567890:topic:42"],      },    },  },}

Разрешение политики:

Поддерживаемая сегодня политика области действия regex:

Конфигурации каналов на уровне аккаунта могут задавать ту же политику в channels.<channel>.accounts.<accountId>.mentionPatterns, когда этот канал поддерживает несколько аккаунтов. Политика аккаунта имеет приоритет над политикой канала верхнего уровня для этого аккаунта.

Ограничения инструментов для групп/каналов (необязательно)

Некоторые конфигурации каналов поддерживают ограничение инструментов, доступных внутри конкретной группы/комнаты/канала.

• tools: разрешить/запретить инструменты для всей группы.
• toolsBySender: переопределения по отправителю внутри группы. Используйте явные префиксы ключей: channel:<channelId>:<senderId>, id:<senderId>, e164:<phone>, username:<handle>, name:<displayName> и подстановочный знак "*". Идентификаторы каналов используют канонические идентификаторы каналов OpenClaw; псевдонимы, такие как teams, нормализуются в msteams. Устаревшие ключи без префикса всё ещё принимаются и сопоставляются только как id:.

Порядок разрешения (побеждает наиболее конкретное):

Пример (Telegram):

{  channels: {    telegram: {      groups: {        "*": { tools: { deny: ["exec"] } },        "-1001234567890": {          tools: { deny: ["exec", "read", "write"] },          toolsBySender: {            "id:123456789": { alsoAllow: ["exec"] },          },        },      },    },  },}

Групповые списки разрешений

Когда настроены channels.whatsapp.groups, channels.telegram.groups или channels.imessage.groups, ключи действуют как групповой список разрешений. Используйте "*", чтобы разрешить все группы, при этом всё ещё задавая поведение упоминаний по умолчанию.

Типовые задачи (скопировать/вставить):

{  channels: { whatsapp: { groupPolicy: "disabled" } },}

{  channels: {    whatsapp: {      groups: {        "123@g.us": { requireMention: true },        "456@g.us": { requireMention: false },      },    },  },}

{  channels: {    whatsapp: {      groups: { "*": { requireMention: true } },    },  },}

{  channels: {    whatsapp: {      groupPolicy: "allowlist",      groupAllowFrom: ["+15551234567"],      groups: { "*": { requireMention: true } },    },  },}

Активация (только владелец)

Владельцы групп могут переключать активацию для каждой группы:

• /activation mention
• /activation always

Владелец определяется по channels.whatsapp.allowFrom (или по собственному номеру бота в формате E.164, если значение не задано). Отправьте команду отдельным сообщением. Другие интерфейсы сейчас игнорируют /activation.

Поля контекста

Входящие групповые полезные нагрузки задают:

• ChatType=group
• GroupSubject (если известно)
• GroupMembers (если известно)
• WasMentioned (результат проверки упоминания)
• Темы форумов Telegram также включают MessageThreadId и IsForum.

Системная подсказка агента включает групповое вступление на первом ходе новой групповой сессии. Оно напоминает модели отвечать как человек, минимизировать пустые строки и соблюдать обычные интервалы чата, а также не вводить буквальные последовательности \n. В группах не из Telegram также не рекомендуется использовать таблицы Markdown; рекомендации по форматированному тексту Telegram поступают из подсказки канала Telegram. Имена групп и метки участников, полученные из каналов, отображаются как огражденные недоверенные метаданные, а не как встроенные системные инструкции.

Особенности iMessage

• Предпочитайте chat_id:<id> при маршрутизации или добавлении в разрешающий список.
• Список чатов: imsg chats --limit 20.
• Ответы в группе всегда возвращаются в тот же chat_id.

Системные подсказки WhatsApp

См. WhatsApp для канонических правил системных подсказок WhatsApp, включая разрешение групповых и прямых подсказок, поведение подстановочных символов и семантику переопределения аккаунта.

Особенности WhatsApp

См. Групповые сообщения для поведения, применимого только к WhatsApp (внедрение истории, подробности обработки упоминаний).

Связано

• Группы рассылки
• Маршрутизация каналов
• Групповые сообщения
• Сопряжение