Regras de push do Matrix para prévias silenciosas

Quando channels.matrix.streaming.mode é "quiet", o OpenClaw transmite a resposta editando um único evento de prévia no próprio local. As prévias são enviadas como eventos m.notice sem notificação, e a edição finalizada é marcada com content["com.openclaw.finalized_preview"] = true. Os clientes Matrix notificam sobre essa edição final somente se uma regra de push por usuário corresponder ao marcador. Esta página é destinada a operadores que hospedam o Matrix por conta própria e desejam instalar essa regra para cada conta destinatária.

streaming.mode: "progress" finaliza seus rascunhos pelo mesmo caminho, portanto a mesma regra também é acionada para edições finalizadas no modo de progresso.

Se quiser apenas o comportamento padrão de notificações do Matrix, use streaming.mode: "partial" ou mantenha a transmissão desativada. Consulte Configuração do canal Matrix.

Pré-requisitos

• usuário destinatário = a pessoa que deve receber a notificação
• usuário bot = a conta Matrix do OpenClaw que envia a resposta
• use o token de acesso do usuário destinatário nas chamadas de API abaixo
• faça sender corresponder ao MXID completo do usuário bot na regra de push
• a conta destinatária já deve ter pushers funcionando; as regras de prévia silenciosa só funcionam quando a entrega normal de push do Matrix está íntegra

Etapas

{channels: {matrix: {  streaming: { mode: "quiet" },},},}

curl -sS -X POST \"https://matrix.example.org/_matrix/client/v3/login" \-H "Content-Type: application/json" \--data '{"type": "m.login.password","identifier": { "type": "m.id.user", "user": "@alice:example.org" },"password": "REDACTED"}'

curl -sS \-H "Authorization: Bearer $USER_ACCESS_TOKEN" \"https://matrix.example.org/_matrix/client/v3/pushers"

curl -sS -X PUT \"https://matrix.example.org/_matrix/client/v3/pushrules/global/override/openclaw-finalized-preview-botname" \-H "Authorization: Bearer $USER_ACCESS_TOKEN" \-H "Content-Type: application/json" \--data '{"conditions": [  { "kind": "event_match", "key": "type", "pattern": "m.room.message" },  {    "kind": "event_property_is",    "key": "content.m\\.relates_to.rel_type",    "value": "m.replace"  },  {    "kind": "event_property_is",    "key": "content.com\\.openclaw\\.finalized_preview",    "value": true  },  { "kind": "event_match", "key": "sender", "pattern": "@bot:example.org" }],"actions": [  "notify",  { "set_tweak": "sound", "value": "default" },  { "set_tweak": "highlight", "value": false }]}'

curl -sS \-H "Authorization: Bearer $USER_ACCESS_TOKEN" \"https://matrix.example.org/_matrix/client/v3/pushrules/global/override/openclaw-finalized-preview-botname"

Para remover a regra posteriormente, DELETE a mesma URL da regra com o token do destinatário.

Observações sobre vários bots

As regras de push são identificadas por ruleId: executar PUT novamente com o mesmo ID atualiza uma única regra. Para que vários bots OpenClaw notifiquem o mesmo destinatário, crie uma regra por bot com uma correspondência de remetente distinta.

Novas regras override definidas pelo usuário são inseridas antes das regras de supressão padrão do servidor, portanto nenhum parâmetro adicional de ordenação é necessário. A regra afeta apenas edições de prévias exclusivamente de texto que podem ser finalizadas no próprio local; respostas com mídia, fallbacks de prévias obsoletas e textos finais que ativariam menções do Matrix são entregues como mensagens normais com notificação.

Observações sobre o homeserver

Relacionados

• Configuração do canal Matrix
• Conceitos de transmissão