Regras de push do Matrix para prévias discretas

Quando channels.matrix.streaming é "quiet", o OpenClaw transmite a resposta editando um único evento de pré-visualização no próprio local. As pré-visualizações são enviadas como eventos m.notice que não geram notificações, 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 destina-se a operadores que hospedam o Matrix por conta própria e desejam instalar essa regra para cada conta destinatária.

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

Se você deseja apenas o comportamento padrão de notificações do Matrix, use streaming: "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 do 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 o sender da regra de push corresponder ao MXID completo do usuário do bot
• a conta destinatária já deve ter pushers funcionando; as regras de pré-visualização silenciosa só funcionam quando a entrega normal de push do Matrix está operando corretamente

Etapas

{channels: {matrix: {  streaming: "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, envie uma solicitação DELETE para a mesma URL da regra usando o token do destinatário.

Observações sobre múltiplos bots

As regras de push são identificadas por ruleId: executar novamente um PUT 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 somente edições de pré-visualização contendo apenas texto que possam ser finalizadas no próprio local; respostas com mídia, alternativas para pré-visualizações obsoletas e textos finais que ativariam menções do Matrix são entregues como mensagens normais com notificação.

Observações sobre o homeserver

Relacionado

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