--- read_when: - Налаштування постійно активних групових або канальних кімнат - Ви хочете, щоб агент стежив за розмовами в кімнаті, не публікуючи фінальний текст автоматично - Налагодження введення та використання токенів без видимого повідомлення в кімнаті sidebarTitle: Ambient room events summary: Нехай підтримувані групові кімнати надають тихий контекст, якщо агент не надсилає повідомлення за допомогою інструмента повідомлень title: Події навколишньої кімнати x-i18n: generated_at: "2026-07-02T17:45:34Z" model: gpt-5.5 postprocess_version: locale-links-v1 provider: openai source_hash: 8e3dcf5abab58d9bfd75b7cef6c8a55b98f6688a895774b8ba4a1ffc5723e0a6 source_path: channels/ambient-room-events.md workflow: 16 --- Фонові події кімнати дають OpenClaw змогу обробляти групові або канальні повідомлення без згадки як тихий контекст. Агент може оновлювати пам’ять і стан сесії, але кімната залишається мовчазною, доки агент явно не викличе інструмент `message`. Для постійно ввімкнених групових чатів це рекомендований режим: поєднайте `messages.groupChat.unmentionedInbound: "room_event"` із `messages.groupChat.visibleReplies: "message_tool"`. Використовуйте його, коли агент має слухати, вирішувати, коли відповідь корисна, і уникати старого шаблону промпта з відповіддю `NO_REPLY`. Підтримується нині: канали гільдій Discord, канали та приватні канали Slack, групові особисті повідомлення Slack із кількома учасниками, а також групи або супергрупи Telegram. Інші групові канали зберігають свою наявну групову поведінку, якщо на сторінці їхнього каналу не вказано, що вони підтримують фонові події кімнати. ## Рекомендоване налаштування Задайте глобальну поведінку групового чату: ```json5 { messages: { groupChat: { unmentionedInbound: "room_event", visibleReplies: "message_tool", historyLimit: 50, }, }, } ``` Потім налаштуйте саму кімнату як постійно ввімкнену, вимкнувши для неї обмеження згадками. Канал усе одно має бути дозволений звичайними `groupPolicy`, списком дозволених кімнат і списком дозволених відправників. Після збереження конфігурації Gateway гаряче перезавантажує налаштування `messages`. Перезапускайте лише тоді, коли спостереження за файлами або перезавантаження конфігурації вимкнено. ## Що змінюється З `messages.groupChat.unmentionedInbound: "room_event"`: - дозволені групові або канальні повідомлення без згадки стають тихими подіями кімнати - повідомлення зі згадкою залишаються запитами користувача - текстові команди та нативні команди залишаються запитами користувача - запити на переривання або зупинку залишаються запитами користувача - прямі повідомлення залишаються запитами користувача Події кімнати використовують сувору видиму доставку. Фінальний текст асистента є приватним. Агент має викликати `message(action=send)`, щоб опублікувати повідомлення в кімнаті. ## Приклад Discord ```json5 { messages: { groupChat: { unmentionedInbound: "room_event", visibleReplies: "message_tool", historyLimit: 50, }, }, channels: { discord: { groupPolicy: "allowlist", guilds: { "": { requireMention: false, users: [""], }, }, }, }, } ``` Використовуйте поканальну конфігурацію Discord, коли фоновим має бути лише один канал: ```json5 { channels: { discord: { guilds: { "": { channels: { "": { allow: true, requireMention: false, }, }, }, }, }, }, } ``` ## Приклад Slack Списки дозволених каналів Slack насамперед використовують ідентифікатори. Використовуйте ідентифікатори каналів, як-от `C12345678`, а не `#channel-name`. ```json5 { messages: { groupChat: { unmentionedInbound: "room_event", visibleReplies: "message_tool", historyLimit: 50, }, }, channels: { slack: { groupPolicy: "allowlist", channels: { "": { allow: true, requireMention: false, }, }, }, }, } ``` ## Приклад Telegram Для груп Telegram бот має мати змогу бачити звичайні групові повідомлення. Якщо `requireMention: false`, вимкніть режим приватності BotFather або використовуйте інше налаштування Telegram, яке доставляє боту весь груповий трафік. ```json5 { messages: { groupChat: { unmentionedInbound: "room_event", visibleReplies: "message_tool", historyLimit: 50, }, }, channels: { telegram: { groups: { "": { groupPolicy: "open", requireMention: false, }, }, }, }, } ``` Ідентифікатори груп Telegram зазвичай є від’ємними числами, як-от `-1001234567890`. Прочитайте `chat.id` з `openclaw logs --follow`, перешліть групове повідомлення боту-помічнику для визначення ID або перегляньте `getUpdates` Bot API. ## Політика для конкретного агента Використовуйте перевизначення агента, коли кілька агентів спільно використовують одну кімнату, але лише один має розглядати повідомлення без згадки як фоновий контекст: ```json5 { messages: { groupChat: { visibleReplies: "message_tool", }, }, agents: { list: [ { id: "main", groupChat: { unmentionedInbound: "room_event", mentionPatterns: ["@openclaw", "openclaw"], }, }, ], }, } ``` Значення `agents.list[].groupChat.unmentionedInbound`, специфічне для агента, перевизначає `messages.groupChat.unmentionedInbound` для цього агента. ## Режими видимих відповідей `messages.groupChat.visibleReplies` за замовчуванням має значення `"automatic"` для звичайних групових або канальних запитів користувача. Залишайте це значення за замовчуванням, коли хочете, щоб фінальний текст асистента публікувався видимо без потреби в явному виклику інструмента повідомлень. Для фонових постійно ввімкнених кімнат `messages.groupChat.visibleReplies: "message_tool"` усе ще рекомендовано, особливо з моделями останнього покоління, що надійно працюють з інструментами, як-от GPT 5.5. Це дає агенту змогу вирішувати, коли говорити, викликаючи інструмент повідомлень. Якщо модель повертає фінальний текст без виклику інструмента, OpenClaw залишає цей фінальний текст приватним і записує метадані пригніченої доставки в журнал. Події кімнати залишаються суворими навіть тоді, коли інші групові запити використовують автоматичні відповіді. Фонові події кімнати без згадки все одно потребують `message(action=send)` для видимого виводу. ## Історія `messages.groupChat.historyLimit` керує глобальним значенням історії групи за замовчуванням. Канали можуть перевизначати його через `channels..historyLimit`, а деякі канали також підтримують обмеження історії для окремих облікових записів. Задайте `historyLimit: 0`, щоб вимкнути контекст групової історії. Канали з підтримкою подій кімнати зберігають нещодавні фонові повідомлення кімнати як контекст. Telegram зберігає постійно ввімкнене рухоме вікно для кожної групи, обмежене `historyLimit`; ходи запитів користувача вибирають записи після останньої зафіксованої відповіді бота, тоді як ходи подій кімнати отримують повне нещодавнє вікно, щоб модель могла бачити власні нещодавні дописи. Застарілий ключ режиму Telegram `includeGroupHistoryContext` видаляється через `openclaw doctor --fix`. ## Усунення несправностей Якщо кімната показує введення або використання токенів, але видимого повідомлення немає: 1. Переконайтеся, що кімната дозволена списком дозволених каналу та списком дозволених відправників. 2. Переконайтеся, що `requireMention: false` задано на очікуваному рівні кімнати. 3. Перевірте, чи `messages.groupChat.unmentionedInbound` або перевизначення агента має значення `"room_event"`. 4. Перегляньте журнали на наявність метаданих пригніченого фінального payload або `didSendViaMessagingTool: false`. 5. Для звичайних групових запитів залиште або відновіть `messages.groupChat.visibleReplies: "automatic"`, якщо хочете, щоб фінальні відповіді публікувалися автоматично. Для фонових кімнат із `message_tool` використовуйте модель або середовище виконання, що надійно викликає інструменти. Якщо фонові кімнати Telegram взагалі не спрацьовують, перевірте режим приватності BotFather і переконайтеся, що Gateway отримує звичайні групові повідомлення. Якщо фонові кімнати Slack не спрацьовують, перевірте, що ключ каналу є ідентифікатором каналу Slack і що застосунок має потрібний scope `channels:history` або `groups:history` для цього типу кімнати. ## Пов’язано - [Групи](/uk/channels/groups) - [Discord](/uk/channels/discord) - [Slack](/uk/channels/slack) - [Telegram](/uk/channels/telegram) - [Усунення несправностей каналів](/uk/channels/troubleshooting) - [Довідник із конфігурації каналів](/uk/gateway/config-channels)