--- read_when: - Configuration de salons de groupe ou de canal toujours actifs - Vous voulez que l’agent surveille les échanges du salon sans publier automatiquement le texte final - Débogage de la saisie et de l’utilisation des tokens sans message visible dans la conversation sidebarTitle: Ambient room events summary: Laisser les salons de groupe pris en charge fournir un contexte discret, sauf si l’agent envoie avec l’outil de messagerie title: Événements ambiants de la pièce x-i18n: generated_at: "2026-07-02T17:36:14Z" model: gpt-5.5 postprocess_version: locale-links-v1 provider: openai source_hash: 8e3dcf5abab58d9bfd75b7cef6c8a55b98f6688a895774b8ba4a1ffc5723e0a6 source_path: channels/ambient-room-events.md workflow: 16 --- Les événements ambiants de salon permettent à OpenClaw de traiter les échanges de groupe ou de canal sans mention comme un contexte discret. L’agent peut mettre à jour la mémoire et l’état de session, mais le salon reste silencieux sauf si l’agent appelle explicitement l’outil `message`. Pour les discussions de groupe toujours actives, c’est le mode recommandé : combinez `messages.groupChat.unmentionedInbound: "room_event"` avec `messages.groupChat.visibleReplies: "message_tool"`. Utilisez-le lorsque l’agent doit écouter, décider quand une réponse est utile et éviter l’ancien modèle de prompt qui consistait à répondre `NO_REPLY`. Pris en charge aujourd’hui : canaux de guildes Discord, canaux Slack et canaux privés, MP Slack à plusieurs personnes, ainsi que groupes ou supergroupes Telegram. Les autres canaux de groupe conservent leur comportement de groupe existant, sauf si leur page de canal indique qu’ils prennent en charge les événements ambiants de salon. ## Configuration recommandée Définissez le comportement global des discussions de groupe : ```json5 { messages: { groupChat: { unmentionedInbound: "room_event", visibleReplies: "message_tool", historyLimit: 50, }, }, } ``` Configurez ensuite le salon lui-même comme toujours actif en désactivant l’obligation de mention pour ce salon. Le canal doit toujours être autorisé par sa `groupPolicy` normale, la liste d’autorisation du salon et la liste d’autorisation des expéditeurs. Après l’enregistrement de la configuration, le Gateway recharge à chaud les paramètres `messages`. Redémarrez uniquement lorsque la surveillance des fichiers ou le rechargement de la configuration est désactivé. ## Ce qui change Avec `messages.groupChat.unmentionedInbound: "room_event"` : - les messages de groupe ou de canal autorisés sans mention deviennent des événements de salon discrets - les messages avec mention restent des requêtes utilisateur - les commandes textuelles et les commandes natives restent des requêtes utilisateur - les requêtes d’abandon ou d’arrêt restent des requêtes utilisateur - les messages directs restent des requêtes utilisateur Les événements de salon utilisent une diffusion visible stricte. Le texte final de l’assistant est privé. L’agent doit appeler `message(action=send)` pour publier dans le salon. ## Exemple Discord ```json5 { messages: { groupChat: { unmentionedInbound: "room_event", visibleReplies: "message_tool", historyLimit: 50, }, }, channels: { discord: { groupPolicy: "allowlist", guilds: { "": { requireMention: false, users: [""], }, }, }, }, } ``` Utilisez la configuration Discord par canal lorsqu’un seul canal doit être ambiant : ```json5 { channels: { discord: { guilds: { "": { channels: { "": { allow: true, requireMention: false, }, }, }, }, }, }, } ``` ## Exemple Slack Les listes d’autorisation de canaux Slack privilégient les ID. Utilisez des ID de canal tels que `C12345678`, et non `#channel-name`. ```json5 { messages: { groupChat: { unmentionedInbound: "room_event", visibleReplies: "message_tool", historyLimit: 50, }, }, channels: { slack: { groupPolicy: "allowlist", channels: { "": { allow: true, requireMention: false, }, }, }, }, } ``` ## Exemple Telegram Pour les groupes Telegram, le bot doit pouvoir voir les messages de groupe normaux. Si `requireMention: false`, désactivez le mode de confidentialité BotFather ou utilisez une autre configuration Telegram qui transmet tout le trafic de groupe au bot. ```json5 { messages: { groupChat: { unmentionedInbound: "room_event", visibleReplies: "message_tool", historyLimit: 50, }, }, channels: { telegram: { groups: { "": { groupPolicy: "open", requireMention: false, }, }, }, }, } ``` Les ID de groupe Telegram sont généralement des nombres négatifs tels que `-1001234567890`. Lisez `chat.id` depuis `openclaw logs --follow`, transférez un message de groupe à un bot assistant d’ID, ou inspectez `getUpdates` de la Bot API. ## Politique propre à l’agent Utilisez un remplacement propre à l’agent lorsque plusieurs agents partagent le même salon, mais qu’un seul doit traiter les échanges sans mention comme contexte ambiant : ```json5 { messages: { groupChat: { visibleReplies: "message_tool", }, }, agents: { list: [ { id: "main", groupChat: { unmentionedInbound: "room_event", mentionPatterns: ["@openclaw", "openclaw"], }, }, ], }, } ``` La valeur propre à l’agent `agents.list[].groupChat.unmentionedInbound` remplace `messages.groupChat.unmentionedInbound` pour cet agent. ## Modes de réponse visible `messages.groupChat.visibleReplies` vaut par défaut `"automatic"` pour les requêtes utilisateur normales de groupe ou de canal. Conservez cette valeur par défaut lorsque vous voulez que le texte final de l’assistant soit publié visiblement sans nécessiter d’appel explicite à l’outil de message. Pour les salons ambiants toujours actifs, `messages.groupChat.visibleReplies: "message_tool"` reste recommandé, en particulier avec des modèles de dernière génération fiables avec les outils, tels que GPT 5.5. Cela permet à l’agent de décider quand parler en appelant l’outil de message. Si le modèle renvoie du texte final sans appeler l’outil, OpenClaw garde ce texte final privé et journalise les métadonnées de diffusion supprimée. Les événements de salon restent stricts même lorsque d’autres requêtes de groupe utilisent des réponses automatiques. Les événements ambiants de salon sans mention nécessitent toujours `message(action=send)` pour produire une sortie visible. ## Historique `messages.groupChat.historyLimit` contrôle la valeur par défaut globale de l’historique de groupe. Les canaux peuvent la remplacer avec `channels..historyLimit`, et certains canaux prennent également en charge des limites d’historique par compte. Définissez `historyLimit: 0` pour désactiver le contexte d’historique de groupe. Les canaux prenant en charge les événements de salon conservent les messages ambiants récents du salon comme contexte. Telegram conserve une fenêtre glissante par groupe toujours active, limitée par `historyLimit` ; les tours de requêtes utilisateur sélectionnent les entrées après la dernière réponse enregistrée du bot, tandis que les tours d’événements de salon reçoivent toute la fenêtre récente afin que le modèle puisse voir ses propres publications récentes. L’ancienne clé de mode Telegram `includeGroupHistoryContext` est supprimée par `openclaw doctor --fix`. ## Dépannage Si le salon affiche une saisie en cours ou une utilisation de tokens, mais aucun message visible : 1. Confirmez que le salon est autorisé par la liste d’autorisation du canal et la liste d’autorisation des expéditeurs. 2. Confirmez que `requireMention: false` est défini au niveau de salon attendu. 3. Vérifiez si `messages.groupChat.unmentionedInbound` ou le remplacement de l’agent vaut `"room_event"`. 4. Inspectez les journaux pour trouver des métadonnées de charge utile finale supprimée ou `didSendViaMessagingTool: false`. 5. Pour les requêtes de groupe normales, conservez ou restaurez `messages.groupChat.visibleReplies: "automatic"` si vous voulez que les réponses finales soient publiées automatiquement. Pour les salons ambiants utilisant `message_tool`, utilisez un modèle ou un runtime qui appelle les outils de façon fiable. Si les salons ambiants Telegram ne se déclenchent pas du tout, vérifiez le mode de confidentialité BotFather et assurez-vous que le Gateway reçoit les messages de groupe normaux. Si les salons ambiants Slack ne se déclenchent pas, vérifiez que la clé de canal est l’ID du canal Slack et que l’application dispose du scope `channels:history` ou `groups:history` requis pour ce type de salon. ## Connexe - [Groupes](/fr/channels/groups) - [Discord](/fr/channels/discord) - [Slack](/fr/channels/slack) - [Telegram](/fr/channels/telegram) - [Dépannage des canaux](/fr/channels/troubleshooting) - [Référence de configuration des canaux](/fr/gateway/config-channels)