--- 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: Permite 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-11T22:54:01Z" model: gpt-5.6 postprocess_version: locale-links-v1 provider: openai source_hash: 3f144b44c8ae0a78e756d741c7b4685632862c0eb15531185ddeb0c2ba801e1a source_path: channels/ambient-room-events.md workflow: 16 --- Los eventos ambientales de sala permiten que OpenClaw procese las conversaciones de grupos o canales que no lo mencionan como contexto silencioso. 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 de responder `NO_REPLY`. Compatibilidad actual: canales de servidores de Discord, canales públicos y privados de Slack, mensajes directos de Slack con varias personas y grupos o supergrupos de Telegram. Los demás canales grupales mantienen su comportamiento existente, 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 el requisito de mención 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 mencionan al agente se convierten en eventos silenciosos de sala - los mensajes que mencionan al agente 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. La indicación 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. Con `groupPolicy: "allowlist"`, incluir el canal 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 por agente cuando varios agentes compartan la misma sala, pero solo uno deba tratar las conversaciones que no lo mencionan como contexto ambiental: ```json5 { messages: { groupChat: { visibleReplies: "message_tool", }, }, agents: { list: [ { id: "main", groupChat: { unmentionedInbound: "room_event", mentionPatterns: ["@openclaw", "openclaw"], }, }, ], }, } ``` El valor específico del agente `agents.list[].groupChat.unmentionedInbound` 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 visiblemente sin una llamada explícita a la herramienta de mensajes. Para salas ambientales siempre activas, se sigue recomendando `messages.groupChat.visibleReplies: "message_tool"`, especialmente con modelos de última generación que utilizan herramientas de forma fiable, como GPT-5.6 Sol. Permite que el agente decida cuándo hablar mediante una llamada 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 mantienen el modo estricto incluso cuando otras solicitudes grupales utilizan respuestas automáticas. Los eventos ambientales de sala que no mencionan al agente siempre requieren `message(action=send)` para generar una salida visible. ## Historial `messages.groupChat.historyLimit` establece el valor global predeterminado del historial grupal (50 cuando 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 compatibles con eventos de sala conservan como contexto los mensajes ambientales recientes de la sala. Telegram mantiene una ventana continua 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 la ventana reciente completa para que el modelo pueda ver sus propias publicaciones recientes. `openclaw doctor --fix` elimina la clave de modo retirada `includeGroupHistoryContext` de Telegram. ## Solución de problemas Si la sala muestra una indicación 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 tiene el valor `"room_event"`. 4. Inspeccione los registros en busca de metadatos de la 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 utilizan `message_tool`, use 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 reciba 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 tenga el ámbito de historial correspondiente a ese tipo de sala: `channels:history` (pública), `groups:history` (privada) o `mpim:history` (mensajes directos con varias personas). ## Contenido relacionado - [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)