OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Configuration

Eventos ambientales de la sala

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: {        "<DISCORD_SERVER_ID>": {          requireMention: false,          users: ["<YOUR_DISCORD_USER_ID>"],        },      },    },  },}

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: {        "<DISCORD_SERVER_ID>": {          channels: {            "<DISCORD_CHANNEL_ID_OR_NAME>": {              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: {        "<SLACK_CHANNEL_ID>": {          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: {        "<TELEGRAM_GROUP_CHAT_ID>": {          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.<channel>.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

Was this useful?
On this page

On this page