Pular para o conteúdo principal
Eventos de sala ambiente permitem que o OpenClaw processe conversas de grupo ou canal sem menção como contexto silencioso. O agente pode atualizar memória e estado da sessão, mas a sala permanece silenciosa a menos que o agente chame explicitamente a ferramenta message. Para chats de grupo sempre ativos, este é o modo recomendado: combine messages.groupChat.unmentionedInbound: "room_event" com messages.groupChat.visibleReplies: "message_tool". Use quando o agente deve escutar, decidir quando uma resposta é útil e evitar o padrão antigo de prompt de responder NO_REPLY. Suportado hoje: canais de guilda do Discord, canais e canais privados do Slack, DMs multipessoa do Slack e grupos ou supergrupos do Telegram. Outros canais de grupo mantêm o comportamento de grupo existente, a menos que a página do canal diga que eles oferecem suporte a eventos de sala ambiente.

​
Configuração recomendada

Defina o comportamento global de chat de grupo: 
{
  messages: {
    groupChat: {
      unmentionedInbound: "room_event",
      visibleReplies: "message_tool",
      historyLimit: 50,
    },
  },
}
Em seguida, configure a própria sala como sempre ativa desabilitando a exigência de menção para essa sala. O canal ainda deve ser permitido por sua groupPolicy normal, pela lista de permissões da sala e pela lista de permissões de remetentes. Depois de salvar a configuração, o Gateway recarrega a quente as configurações de messages. Reinicie somente quando o monitoramento de arquivos ou o recarregamento de configuração estiver desabilitado.

​
O que muda

Com messages.groupChat.unmentionedInbound: "room_event":
  • mensagens de grupo ou canal permitidas sem menção se tornam eventos de sala silenciosos
  • mensagens com menção continuam sendo solicitações do usuário
  • comandos de texto e comandos nativos continuam sendo solicitações do usuário
  • solicitações de abortar ou parar continuam sendo solicitações do usuário
  • mensagens diretas continuam sendo solicitações do usuário
Eventos de sala usam entrega visível estrita. O texto final do assistente é privado. O agente deve chamar message(action=send) para publicar na sala.

​
Exemplo do 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 configuração do Discord por canal quando apenas um canal deve ser ambiente: 
{
  channels: {
    discord: {
      guilds: {
        "<DISCORD_SERVER_ID>": {
          channels: {
            "<DISCORD_CHANNEL_ID_OR_NAME>": {
              allow: true,
              requireMention: false,
            },
          },
        },
      },
    },
  },
}

​
Exemplo do Slack

Listas de permissões de canais do Slack priorizam IDs. Use IDs de canal como C12345678, não #channel-name. 
{
  messages: {
    groupChat: {
      unmentionedInbound: "room_event",
      visibleReplies: "message_tool",
      historyLimit: 50,
    },
  },
  channels: {
    slack: {
      groupPolicy: "allowlist",
      channels: {
        "<SLACK_CHANNEL_ID>": {
          allow: true,
          requireMention: false,
        },
      },
    },
  },
}

​
Exemplo do Telegram

Para grupos do Telegram, o bot deve conseguir ver mensagens normais do grupo. Se requireMention: false, desabilite o modo de privacidade do BotFather ou use outra configuração do Telegram que entregue todo o tráfego do grupo ao bot. 
{
  messages: {
    groupChat: {
      unmentionedInbound: "room_event",
      visibleReplies: "message_tool",
      historyLimit: 50,
    },
  },
  channels: {
    telegram: {
      groups: {
        "<TELEGRAM_GROUP_CHAT_ID>": {
          groupPolicy: "open",
          requireMention: false,
        },
      },
    },
  },
}
IDs de grupo do Telegram geralmente são números negativos como -1001234567890. Leia chat.id em openclaw logs --follow, encaminhe uma mensagem do grupo para um bot auxiliar de ID ou inspecione getUpdates da Bot API.

​
Política específica do agente

Use uma substituição de agente quando vários agentes compartilham a mesma sala, mas apenas um deve tratar conversas sem menção como contexto ambiente: 
{
  messages: {
    groupChat: {
      visibleReplies: "message_tool",
    },
  },
  agents: {
    list: [
      {
        id: "main",
        groupChat: {
          unmentionedInbound: "room_event",
          mentionPatterns: ["@openclaw", "openclaw"],
        },
      },
    ],
  },
}
O valor específico do agente agents.list[].groupChat.unmentionedInbound substitui messages.groupChat.unmentionedInbound para esse agente.

​
Modos de resposta visível

messages.groupChat.visibleReplies usa "automatic" como padrão para solicitações normais de usuário em grupo/canal. Mantenha esse padrão quando quiser que o texto final do assistente seja publicado visivelmente sem exigir uma chamada explícita à ferramenta de mensagens. Para salas ambiente sempre ativas, messages.groupChat.visibleReplies: "message_tool" ainda é recomendado, especialmente com modelos de última geração e confiáveis no uso de ferramentas, como GPT 5.5. Ele permite que o agente decida quando falar chamando a ferramenta de mensagens. Se o modelo retornar texto final sem chamar a ferramenta, o OpenClaw mantém esse texto final privado e registra metadados de entrega suprimida. Eventos de sala permanecem estritos mesmo quando outras solicitações de grupo usam respostas automáticas. Eventos de sala ambiente sem menção ainda exigem message(action=send) para saída visível.

​
Histórico

messages.groupChat.historyLimit controla o padrão global de histórico de grupo. Canais podem substituí-lo com channels.<channel>.historyLimit, e alguns canais também oferecem suporte a limites de histórico por conta. Defina historyLimit: 0 para desabilitar o contexto de histórico de grupo. Canais com suporte a eventos de sala mantêm mensagens de sala ambiente recentes como contexto. O Telegram mantém uma janela contínua sempre ativa por grupo, limitada por historyLimit; turnos de solicitação do usuário selecionam entradas após a última resposta registrada do bot, enquanto turnos de evento de sala recebem a janela recente completa para que o modelo possa ver suas próprias publicações recentes. A chave de modo aposentada includeGroupHistoryContext do Telegram é removida por openclaw doctor --fix.

​
Solução de problemas

Se a sala mostrar digitação ou uso de tokens, mas nenhuma mensagem visível:
  1. Confirme que a sala é permitida pela lista de permissões do canal e pela lista de permissões de remetentes.
  2. Confirme que requireMention: false está definido no nível de sala esperado.
  3. Verifique se messages.groupChat.unmentionedInbound ou a substituição do agente é "room_event".
  4. Inspecione os logs em busca de metadados de payload final suprimido ou didSendViaMessagingTool: false.
  5. Para solicitações normais de grupo, mantenha ou restaure messages.groupChat.visibleReplies: "automatic" se quiser que respostas finais sejam publicadas automaticamente. Para salas ambiente usando message_tool, use um modelo/runtime que chame ferramentas de forma confiável.
Se salas ambiente do Telegram não dispararem de forma alguma, verifique o modo de privacidade do BotFather e confirme que o Gateway está recebendo mensagens normais do grupo. Se salas ambiente do Slack não dispararem, verifique se a chave do canal é o ID do canal Slack e se o app tem o escopo channels:history ou groups:history necessário para esse tipo de sala.

​
Relacionado