Événements ambiants de la pièce

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 :

{  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

{  messages: {    groupChat: {      unmentionedInbound: "room_event",      visibleReplies: "message_tool",      historyLimit: 50,    },  },  channels: {    discord: {      groupPolicy: "allowlist",      guilds: {        "<DISCORD_SERVER_ID>": {          requireMention: false,          users: ["<YOUR_DISCORD_USER_ID>"],        },      },    },  },}

Utilisez la configuration Discord par canal lorsqu’un seul canal doit être ambiant :

{  channels: {    discord: {      guilds: {        "<DISCORD_SERVER_ID>": {          channels: {            "<DISCORD_CHANNEL_ID_OR_NAME>": {              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.

{  messages: {    groupChat: {      unmentionedInbound: "room_event",      visibleReplies: "message_tool",      historyLimit: 50,    },  },  channels: {    slack: {      groupPolicy: "allowlist",      channels: {        "<SLACK_CHANNEL_ID>": {          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.

{  messages: {    groupChat: {      unmentionedInbound: "room_event",      visibleReplies: "message_tool",      historyLimit: 50,    },  },  channels: {    telegram: {      groups: {        "<TELEGRAM_GROUP_CHAT_ID>": {          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 :

{  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.<channel>.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
• Discord
• Slack
• Telegram
• Dépannage des canaux
• Référence de configuration des canaux