Controle de acesso do Matrix no OpenClaw

O Matrix não tem flag de bot nem listas de permissões no servidor, e seus clientes completam uma menção com Tab antes de cada comando; as regras de acesso do OpenClaw refletem essas três coisas. Aqui estão as configurações de bot para bot, o controle de visibilidade do contexto, as políticas de mensagens diretas e de salas, o pareamento e o caminho dos comandos prefixados por menção.

Salas de bot para bot

• Mensagens de outras contas Matrix do OpenClaw configuradas são ignoradas por padrão, e a configuração allow-bots ativa o tráfego entre agentes: true aceita mensagens de outras contas de bot configuradas em salas e mensagens diretas permitidas, mentions as aceita nas salas só quando elas mencionam visivelmente este bot, enquanto as mensagens diretas continuam permitidas, e um valor allow-bots por sala substitui a configuração no nível da conta.
• Mensagens aceitas de bots configurados usam a proteção compartilhada contra loops de bots, configurada nos padrões dos canais e substituída por conta ou por sala.
• O OpenClaw continua ignorando mensagens do mesmo ID de usuário Matrix para evitar loops de autorresposta, e, como o Matrix não tem uma flag de bot nativa, autoria de bot significa uma mensagem enviada por outra conta Matrix configurada neste gateway do OpenClaw.
• O conselho da documentação para salas compartilhadas é usar listas de permissões de salas estritas e exigência de menção sempre que o tráfego de bot para bot estiver ativado.

Isso afeta apenas a visibilidade do contexto suplementar, não se a própria mensagem recebida pode disparar uma resposta.

Visibilidade do contexto e políticas

O Matrix suporta o controle compartilhado de visibilidade do contexto para o contexto suplementar da sala, como o texto de respostas recuperadas, raízes de thread e histórico pendente: all, o padrão, mantém o contexto suplementar como foi recebido, allowlist o filtra para remetentes permitidos pelas verificações ativas de listas de permissões de salas e de usuários, e allowlist-quote se comporta como allowlist, mas mantém uma resposta citada explícita; isso afeta apenas qual contexto suplementar fica visível, nunca se a mensagem recebida pode disparar uma resposta, o que continua vindo da política de grupo, do mapa de salas, da lista de remetentes do grupo e das configurações de mensagens diretas. O exemplo de política define a política de mensagens diretas como allowlist, com um remetente administrador e as respostas em thread desativadas, uma política de grupo allowlist com o mesmo administrador como remetente do grupo, e uma entrada de sala com exigência de menção; para silenciar totalmente as mensagens diretas enquanto as salas continuam funcionando, você desativa o bloco de mensagens diretas e mantém a política de salas e sua lista de remetentes. O pareamento para mensagens diretas no Matrix usa os comandos pairing list e approve, e quando um usuário não aprovado continua mandando mensagens antes da aprovação, o OpenClaw reutiliza o mesmo código pendente e pode enviar um lembrete após um cooldown curto, em vez de gerar um novo.

Comandos de barra nas salas

• Comandos de barra como new, reset, model, agents, session, acp e approve funcionam diretamente nas mensagens diretas.
• Nas salas, o OpenClaw também reconhece um comando prefixado pela própria menção Matrix do bot, então uma menção seguida do comando new dispara o caminho de comando sem uma regex de menção personalizada, o que mantém o bot responsivo às mensagens do tipo menção e depois comando que o Element e clientes semelhantes emitem quando o usuário completa o nome do bot com Tab antes de digitar.
• A autorização continua valendo: quem envia comandos precisa satisfazer as mesmas políticas de lista de permissões e de proprietário de mensagens diretas ou de salas que as mensagens comuns.

O OpenClaw no Matrix é o post do canal ao qual essas regras pertencem, e contas e homeservers do Matrix no OpenClaw, o modelo de múltiplas contas e de homeservers do qual a definição de allow-bots depende.

Como definir um bot em uma plataforma sem esse conceito

Como o Matrix não consegue distinguir um bot de uma pessoa, o OpenClaw traça a linha na própria configuração: outra conta no mesmo gateway é um bot, todo o resto é usuário, e a proteção contra loops fica atrás dessa linha. A proteção contra loops de bots do OpenClaw explica a proteção, e o controle de acesso do Slack no OpenClaw, as mesmas camadas de política no Slack, onde a plataforma marca os bots.

Na Diali

O Matrix está na lista de canais conectáveis da Diali, junto com WhatsApp, Telegram, Discord, Slack, Mattermost, SMS e voz: a conta no homeserver e a lista de permissões de salas são suas, o Gateway é nosso. O OpenClaw hospedado na Diali é o assistente, e a segurança da Diali descreve a fronteira que se aplica a cada canal conectado.

• Outras contas configuradas são bots; o mesmo ID nunca recebe resposta.
• A visibilidade do contexto filtra o que é visto, não o que dispara.
• Uma menção mais um comando continua sendo um comando.