--- read_when: - Configuración de salas de grupo o canal siempre activas - Quieres que el agente supervise la conversación de la sala sin publicar automáticamente el texto final. - Depuración de la escritura y el uso de tokens sin mensajes visibles en la sala sidebarTitle: Ambient room events summary: Permitir que las salas de grupo compatibles proporcionen contexto silencioso, a menos que el agente envíe un mensaje con la herramienta de mensajes title: Eventos ambientales de la sala x-i18n: generated_at: "2026-07-26T05:05:30Z" model: gpt-5.6 postprocess_version: locale-links-v1 prompt_version: 32 provider: openai source_hash: 15c083c139058c9bd2c651794965bd8252d74691e536db2ad2a2ae0b4ac886e8 source_path: channels/ambient-room-events.md workflow: 16 --- Los eventos ambientales de sala permiten que OpenClaw procese como contexto discreto las conversaciones de grupos o canales que no lo mencionan. El agente puede actualizar la memoria y el estado de la sesión, pero la sala permanece en silencio a menos que el agente llame explícitamente a la herramienta `message`. Para chats grupales siempre activos, combine `messages.groupChat.unmentionedInbound: "room_event"` con `messages.groupChat.visibleReplies: "message_tool"`. El agente escucha, decide cuándo resulta útil responder y ya no necesita el antiguo patrón de prompt que respondía `NO_REPLY`. Compatibilidad actual: canales de servidores de Discord, canales y canales privados de Slack, mensajes directos de Slack con varias personas y grupos o supergrupos de Telegram. Los demás canales grupales conservan su comportamiento actual, salvo que la página del canal indique que admiten eventos ambientales de sala. ## Configuración recomendada Establezca el comportamiento global de los chats grupales: ```json5 { messages: { groupChat: { unmentionedInbound: "room_event", visibleReplies: "message_tool", historyLimit: 50, }, }, } ``` A continuación, haga que la sala esté siempre activa deshabilitando la exigencia de menciones para esa sala. La sala aún debe cumplir su `groupPolicy`, la lista de permitidos de la sala y la lista de remitentes permitidos habituales. Después de guardar la configuración, el Gateway aplica en caliente los ajustes de `messages`. Reinícielo únicamente cuando la observación de archivos o la recarga de la configuración estén deshabilitadas (`gateway.reload.mode: "off"`). ## Qué cambia Con `messages.groupChat.unmentionedInbound: "room_event"`: - los mensajes permitidos de grupos o canales que no incluyan una mención se convierten en eventos discretos de sala - los mensajes con menciones siguen siendo solicitudes del usuario - los comandos de control de texto y los comandos nativos siguen siendo solicitudes del usuario - las solicitudes de cancelación o detención siguen siendo solicitudes del usuario - los mensajes directos siguen siendo solicitudes del usuario Los eventos de sala utilizan una entrega visible estricta. El texto final del asistente es privado. El agente debe llamar a `message(action=send)` para publicar en la sala. Las indicaciones de escritura y las reacciones de estado del ciclo de vida permanecen suprimidas para los eventos de sala. La única excepción explícita de confirmación es `messages.ackReactionScope: "all"`, que envía la reacción de confirmación configurada; utilice un ámbito más restringido o `"off"` cuando la sala deba permanecer completamente en silencio. ## Ejemplo de Discord ```json5 { messages: { groupChat: { unmentionedInbound: "room_event", visibleReplies: "message_tool", historyLimit: 50, }, }, channels: { discord: { groupPolicy: "allowlist", guilds: { "": { requireMention: false, users: [""], }, }, }, }, } ``` Utilice la configuración por canal de Discord cuando solo un canal deba ser ambiental. En `groupPolicy: "allowlist"`, incluir el canal en la lista es lo que lo permite (`enabled: false` deshabilita una entrada): ```json5 { channels: { discord: { groupPolicy: "allowlist", guilds: { "": { channels: { "": { requireMention: false, }, }, }, }, }, }, } ``` ## Ejemplo de Slack Las listas de canales permitidos de Slack priorizan los identificadores. Utilice identificadores de canal como `C12345678`, no `#channel-name`. Incluir el canal en `channels.slack.channels` es lo que lo permite (`enabled: false` deshabilita una entrada): ```json5 { messages: { groupChat: { unmentionedInbound: "room_event", visibleReplies: "message_tool", historyLimit: 50, }, }, channels: { slack: { groupPolicy: "allowlist", channels: { "": { requireMention: false, }, }, }, }, } ``` ## Ejemplo de Telegram Para los grupos de Telegram, el bot debe poder ver los mensajes grupales normales. Si `requireMention: false`, deshabilite el modo de privacidad de BotFather o utilice otra configuración de Telegram que entregue al bot todo el tráfico del grupo. ```json5 { messages: { groupChat: { unmentionedInbound: "room_event", visibleReplies: "message_tool", historyLimit: 50, }, }, channels: { telegram: { groups: { "": { groupPolicy: "open", requireMention: false, }, }, }, }, } ``` Los identificadores de grupos de Telegram suelen ser números negativos como `-1001234567890`. Lea `chat.id` desde `openclaw logs --follow`, reenvíe un mensaje del grupo a un bot auxiliar de identificación o inspeccione `getUpdates` de la API de bots. ## Política específica del agente Utilice una anulación del agente cuando varios agentes compartan la misma sala, pero solo uno deba tratar las conversaciones sin menciones como contexto ambiental: ```json5 { messages: { groupChat: { visibleReplies: "message_tool", }, }, agents: { list: [ { id: "main", groupChat: { unmentionedInbound: "room_event", mentionPatterns: ["@openclaw", "openclaw"], }, }, ], }, } ``` El valor `agents.entries.*.groupChat.unmentionedInbound` específico del agente anula `messages.groupChat.unmentionedInbound` para ese agente. ## Modos de respuesta visible El valor predeterminado de `messages.groupChat.visibleReplies` es `"automatic"` para las solicitudes normales del usuario en grupos o canales. Mantenga ese valor predeterminado cuando el texto final del asistente deba publicarse de forma visible sin una llamada explícita a la herramienta de mensajes. Para las salas ambientales siempre activas, se sigue recomendando `messages.groupChat.visibleReplies: "message_tool"`, especialmente con modelos de última generación fiables en el uso de herramientas, como GPT-5.6 Sol. Permite que el agente decida cuándo intervenir llamando a la herramienta de mensajes. Si el modelo devuelve texto final sin llamar a la herramienta, OpenClaw mantiene ese texto final en privado y registra metadatos de entrega suprimida. Los eventos de sala siguen siendo estrictos incluso cuando otras solicitudes grupales utilizan respuestas automáticas. Los eventos ambientales de sala sin menciones siempre requieren `message(action=send)` para generar una salida visible. ## Historial `messages.groupChat.historyLimit` establece el valor global predeterminado del historial de grupos (50 si no se configura; debe ser un entero positivo). Los canales pueden anularlo con `channels..historyLimit` y algunos canales también admiten límites de historial por cuenta. Establezca `historyLimit: 0` en el nivel del canal para deshabilitar el contexto del historial grupal de ese canal. Los canales que admiten eventos de sala conservan como contexto los mensajes ambientales recientes de la sala. Telegram mantiene una ventana móvil por grupo, siempre activa y limitada por `historyLimit`; los turnos de solicitudes del usuario seleccionan las entradas posteriores a la última respuesta registrada del bot, mientras que los turnos de eventos de sala reciben toda la ventana reciente para que el modelo pueda ver sus propias publicaciones recientes. `openclaw doctor --fix` elimina la clave de modo obsoleta `includeGroupHistoryContext` de Telegram. ## Solución de problemas Si la sala muestra actividad de escritura o uso de tokens, pero ningún mensaje visible: 1. Confirme que la sala esté permitida por la lista de canales permitidos y la lista de remitentes permitidos. 2. Confirme que `requireMention: false` esté configurado en el nivel de sala esperado. 3. Compruebe si `messages.groupChat.unmentionedInbound` o la anulación del agente es `"room_event"`. 4. Inspeccione los registros en busca de metadatos de carga final suprimida o `didSendViaMessagingTool: false`. 5. Para las solicitudes grupales normales, mantenga o restaure `messages.groupChat.visibleReplies: "automatic"` si desea que las respuestas finales se publiquen automáticamente. Para las salas ambientales que utilicen `message_tool`, emplee un modelo o entorno de ejecución que llame a las herramientas de forma fiable. Si las salas ambientales de Telegram no se activan en absoluto, compruebe el modo de privacidad de BotFather y verifique que el Gateway esté recibiendo los mensajes grupales normales. Si las salas ambientales de Slack no se activan, verifique que la clave del canal sea el identificador del canal de Slack y que la aplicación disponga del ámbito de historial correspondiente a ese tipo de sala: `channels:history` (pública), `groups:history` (privada) o `mpim:history` (mensajes directos con varias personas). ## Temas relacionados - [Grupos](/es/channels/groups) - [Discord](/es/channels/discord) - [Slack](/es/channels/slack) - [Telegram](/es/channels/telegram) - [Solución de problemas de canales](/es/channels/troubleshooting) - [Referencia de configuración de canales](/es/gateway/config-channels)