Regras de push do Matrix para pré-visualizações silenciosas

Configurar prévias silenciosas

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

Obter o token de acesso do destinatário

Reutilize um token de sessão de cliente existente quando possível. Para gerar um novo:

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"
}'

Verificar se existem pushers

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

Se nenhum pusher for retornado, corrija a entrega normal de push do Matrix para esta conta antes de continuar.

Instalar a regra de push de override

O OpenClaw marca edições finalizadas de prévias somente texto com content["com.openclaw.finalized_preview"] = true. Instale uma regra que corresponda a esse marcador e ao MXID do bot como remetente:

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 }
]
}'

Substitua antes de executar:

• https://matrix.example.org: a URL base do seu homeserver
• $USER_ACCESS_TOKEN: o token de acesso do usuário destinatário
• openclaw-finalized-preview-botname: um ID de regra exclusivo por bot por destinatário (padrão: openclaw-finalized-preview-<botname>)
• @bot:example.org: o MXID do seu bot OpenClaw, não o do destinatário

Verificar

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

Depois, teste uma resposta transmitida. No modo silencioso, a sala mostra uma prévia de rascunho silenciosa e notifica uma vez quando o bloco ou turno termina.