Regras de push do Matrix no OpenClaw para prévias silenciosas

O streaming no modo quiet resolve metade do problema de notificações do Matrix: o bot para de tocar a cada edição. A outra metade fica do lado do homeserver, porque só uma regra de push na conta do destinatário pode dizer qual edição merece uma notificação. Esta página é para operadores que hospedam o próprio Synapse ou Tuwunel e querem essa regra instalada para cada destinatário. Aqui estão o mecanismo, os passos, a regra para vários bots e as duas notas sobre homeservers.

O mecanismo

• Com o modo de streaming definido como quiet, o OpenClaw transmite a resposta editando no lugar um único evento de prévia; as prévias são enviadas como eventos notice que não notificam, a edição finalizada é marcada com uma propriedade do OpenClaw de prévia finalizada, e os clientes notificam sobre essa edição final apenas se uma regra de push por usuário corresponder ao marcador.
• O modo progress finaliza seus rascunhos pelo mesmo caminho, então a mesma regra também dispara para edições finalizadas no modo progress, e operadores que querem apenas o comportamento de notificação padrão usam o modo partial ou deixam o streaming desativado.
• Os pré-requisitos são um usuário destinatário que deve receber a notificação, o usuário bot que envia a resposta, o token de acesso do destinatário para as chamadas de API, o ID Matrix completo do bot como correspondência de remetente na regra e uma conta de destinatário que já tenha pushers funcionando, porque as regras de prévia silenciosa só funcionam quando a entrega normal de push está saudável.
• Os passos começam configurando o modo quiet no bloco do canal e obtendo o token de acesso do destinatário, reutilizando um token de sessão de cliente existente sempre que possível ou gerando um com uma requisição de login por senha no homeserver, e exportando-o para as chamadas seguintes.

As regras de push são indexadas por ruleId: executar PUT novamente contra o mesmo ID atualiza uma única regra.

Como instalar a regra

Verifique os pushers com o endpoint de pushers usando o token do destinatário e, se nenhum voltar, corrija a entrega normal de push dessa conta antes de continuar. Depois instale uma regra de push override sob um ID de regra único por bot e por destinatário, seguindo o padrão de prévia finalizada com o nome do bot, cujas quatro condições correspondem a um tipo de evento de mensagem de sala, a um tipo de relação replace, à propriedade de prévia finalizada definida como true e ao remetente igual ao ID completo do bot, com as ações notify, o tweak de som padrão e highlight desativado; substitua a URL do homeserver, o token, o ID da regra e o ID do bot, lembrando que o remetente é o bot, e não o destinatário. Verifique buscando a mesma URL da regra e depois teste uma resposta em streaming: no modo quiet, a sala mostra uma prévia de rascunho silenciosa e notifica quando o bloco ou o turno termina, e a regra é removida depois excluindo a mesma URL com o token do destinatário.

Vários bots e homeservers

• As regras de push são indexadas pelo ID da regra, então executar a instalação novamente contra o mesmo ID atualiza uma única regra, e vários bots do OpenClaw notificando o mesmo destinatário precisam de uma regra por bot, com uma correspondência de remetente distinta; novas regras override definidas pelo usuário são inseridas antes das regras suppress padrão do servidor, então nenhum parâmetro de ordenação é necessário.
• A regra afeta apenas edições de prévia só de texto que podem ser finalizadas no lugar: respostas com mídia, fallbacks de prévia obsoleta e textos finais que ativariam menções do Matrix são entregues como mensagens normais, que notificam.
• O Synapse não precisa de nenhuma mudança de configuração no homeserver, apenas que o caminho de push-rules chegue ao Synapse por qualquer proxy ou arranjo de workers e que o processo de pusher esteja saudável, e, como a regra usa a condição event-property-is adicionada ao Synapse em 2023, versões mais antigas aceitam a chamada de instalação, mas silenciosamente nunca correspondem, então uma edição finalizada que nunca notifica significa que é hora de atualizar; o Tuwunel segue o mesmo fluxo sem configuração específica, e notificações que somem enquanto o usuário está ativo em outro lugar apontam para a opção suppress-push-when-active dele, adicionada na 1.4.2, que suprime intencionalmente os pushes para outros dispositivos enquanto um deles está ativo.

OpenClaw no Matrix é o artigo do canal ao qual essa regra serve, e comportamento das mensagens do Matrix no OpenClaw, o modo de streaming quiet que ela completa.

Uma regra por destinatário, por bot

O design mantém a decisão do lado do destinatário: o bot apenas marca a edição final, e cada pessoa instala uma regra que diz se esse marcador deve tocar, por bot, e é por isso que o ID da regra leva o nome do bot. Contas e homeservers do Matrix no OpenClaw cobre como rodar várias contas de bot em um homeserver, e criptografia do Matrix no OpenClaw, a verificação que mantém essas contas confiáveis.

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. OpenClaw hospedado na Diali é o assistente, e a página de segurança da Diali descreve a fronteira que se aplica a cada canal conectado.

• O modo quiet marca a edição final; a regra do destinatário toca nela.
• Primeiro pushers saudáveis, depois a regra override.
• Um Synapse antigo aceita a regra e nunca corresponde a ela.