Eventos de sala ambiental

Los eventos de sala ambiental permiten que OpenClaw procese las conversaciones no mencionadas de grupos o canales 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 de grupo siempre activos, este es el modo recomendado: combine messages.groupChat.unmentionedInbound: "room_event" con messages.groupChat.visibleReplies: "message_tool". Úselo cuando el agente debe escuchar, decidir cuándo es útil una respuesta y evitar el antiguo patrón de prompt de responder NO_REPLY.

Compatible hoy: canales de gremios de Discord, canales y canales privados de Slack, mensajes directos multipersonales de Slack y grupos o supergrupos de Telegram. Otros canales de grupo mantienen su comportamiento de grupo existente a menos que su página de canal indique que admiten eventos de sala ambiental.

Configuración recomendada

Establezca el comportamiento global del chat de grupo:

{
  messages: {
    groupChat: {
      unmentionedInbound: "room_event",
      visibleReplies: "message_tool",
      historyLimit: 50,
    },
  },
}

Luego configure la sala本身 como siempre activa deshabilitando el filtrado de menciones para esa sala. El canal aún debe estar permitido por su groupPolicy normal, lista de permitidos de salas y lista de permitidos de remitentes.

Después de guardar la configuración, el Gateway recarga en caliente la configuración messages. Reinicie solo cuando la observación de archivos o la recarga de configuración estén deshabilitadas.

Qué cambia

Con messages.groupChat.unmentionedInbound: "room_event":

los mensajes permitidos de grupo o canal no mencionados se convierten en eventos de sala silenciosos
los mensajes mencionados siguen siendo solicitudes de usuario
los comandos de texto y los comandos nativos siguen siendo solicitudes de usuario
las solicitudes de abortar o detener siguen siendo solicitudes de usuario
los mensajes directos siguen siendo solicitudes de usuario

Los eventos de sala utilizan entrega estricta visible. El texto final del asistente es privado. El agente debe llamar a message(action=send) para publicar en la sala.

Ejemplo de 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>"],
        },
      },
    },
  },
}

Use la configuración de Discord por canal cuando solo un canal deba ser ambiental:

{
  channels: {
    discord: {
      guilds: {
        "<DISCORD_SERVER_ID>": {
          channels: {
            "<DISCORD_CHANNEL_ID_OR_NAME>": {
              allow: true,
              requireMention: false,
            },
          },
        },
      },
    },
  },
}

Ejemplo de Slack

Las listas de permitidos de canales de Slack son prioritarias por ID. Use ID de canal como C12345678, no #channel-name.

{
  messages: {
    groupChat: {
      unmentionedInbound: "room_event",
      visibleReplies: "message_tool",
      historyLimit: 50,
    },
  },
  channels: {
    slack: {
      groupPolicy: "allowlist",
      channels: {
        "<SLACK_CHANNEL_ID>": {
          allow: true,
          requireMention: false,
        },
      },
    },
  },
}

Ejemplo de Telegram

Para los grupos de Telegram, el bot debe poder ver los mensajes normales del grupo. Si requireMention: false, desactiva el modo de privacidad de BotFather o utiliza otra configuración de Telegram que entregue todo el tráfico del grupo al bot.

{
  messages: {
    groupChat: {
      unmentionedInbound: "room_event",
      visibleReplies: "message_tool",
      historyLimit: 50,
    },
  },
  channels: {
    telegram: {
      groups: {
        "<TELEGRAM_GROUP_CHAT_ID>": {
          groupPolicy: "open",
          requireMention: false,
        },
      },
    },
  },
}

Los ID de grupo de Telegram suelen ser números negativos como -1001234567890. Lee chat.id de openclaw logs --follow, reenvía un mensaje del grupo a un bot auxiliar de ID, o inspecciona la getUpdates de la Bot API.

Política específica del agente

Utiliza un override del agente cuando varios agentes compartan la misma sala pero solo uno deba tratar el chat sin mención como contexto ambiente:

{
  messages: {
    groupChat: {
      visibleReplies: "message_tool",
    },
  },
  agents: {
    list: [
      {
        id: "main",
        groupChat: {
          unmentionedInbound: "room_event",
          mentionPatterns: ["@openclaw", "openclaw"],
        },
      },
    ],
  },
}

El valor agents.list[].groupChat.unmentionedInbound específico del agente anula messages.groupChat.unmentionedInbound para ese agente.

Modos de respuesta visibles

messages.groupChat.visibleReplies por defecto es "automatic" para las solicitudes de usuarios de grupos/canales normales. Mantenga ese valor predeterminado cuando desee que el texto final del asistente se publique visiblemente sin requerir una llamada explícita a la herramienta de mensaje.

Para salas ambiente siempre activas, messages.groupChat.visibleReplies: "message_tool" sigue siendo recomendado, especialmente con modelos de última generación confiables en herramientas como GPT 5.5. Permite que el agente decida cuándo hablar llamando a la herramienta de mensaje. Si el modelo devuelve texto final sin llamar a la herramienta, OpenClaw mantiene ese texto final privado y registra los metadatos de entrega suprimidos.

Los eventos de la sala se mantienen estrictos incluso cuando otras solicitudes grupales usan respuestas automáticas. Los eventos de sala ambiente no mencionados aún requieren message(action=send) para una salida visible.

Historial

messages.groupChat.historyLimit controla el valor predeterminado global del historial de grupos. Los canales pueden anularlo con channels.<channel>.historyLimit, y algunos canales también admiten límites de historial por cuenta.

Establezca historyLimit: 0 para desactivar el contexto del historial de grupos.

Los canales compatibles con eventos de sala mantienen los mensajes de sala ambiente recientes como contexto. Discord mantiene el historial de eventos de sala hasta que tenga éxito un envío visible de Discord, por lo que el contexto silencioso no se pierde antes de la entrega de la herramienta de mensaje.

Solución de problemas

Si la sala muestra actividad de escritura o uso de tokens pero ningún mensaje visible:

Confirma que la sala está permitida por la lista de permitidos de canales y la lista de permitidos de remitentes.
Confirme que requireMention: false está configurado en el nivel de sala que espera.
Compruebe si messages.groupChat.unmentionedInbound o la anulación del agente es "room_event".
Inspeccione los registros en busca de metadatos de carga final suprimidos o didSendViaMessagingTool: false.
Para las solicitudes de grupo normales, mantenga o restaure messages.groupChat.visibleReplies: "automatic" si desea que las respuestas finales se publiquen automáticamente. Para las salas ambiente que usan message_tool, utilice un modelo/tiempo de ejecución que llame a las herramientas de manera confiable.

Si las salas ambientales de Telegram no se activan en absoluto, verifique el modo de privacidad de BotFather y asegúrese de que el Gateway esté recibiendo mensajes de grupo normales.

Si las salas ambiente de Slack no se activan, verifique que la clave del canal sea el ID del canal de Slack y que la aplicación tenga el alcance channels:history o groups:history requerido para ese tipo de sala.