Regole push di Matrix per anteprime discrete

Quando channels.matrix.streaming.mode è "quiet", OpenClaw trasmette la risposta modificando sul posto un singolo evento di anteprima. Le anteprime vengono inviate come eventi m.notice che non generano notifiche e la modifica finalizzata viene contrassegnata con content["com.openclaw.finalized_preview"] = true. I client Matrix generano una notifica per la modifica finale solo se una regola push per utente corrisponde al marcatore. Questa pagina è destinata agli operatori che ospitano autonomamente Matrix e desiderano installare tale regola per ciascun account destinatario.

streaming.mode: "progress" finalizza le proprie bozze tramite lo stesso percorso, quindi la stessa regola viene attivata anche per le modifiche finalizzate in modalità avanzamento.

Se si desidera soltanto il comportamento di notifica standard di Matrix, usare streaming.mode: "partial" oppure lasciare disattivato lo streaming. Consultare Configurazione del canale Matrix.

Prerequisiti

• utente destinatario = la persona che deve ricevere la notifica
• utente bot = l'account Matrix di OpenClaw che invia la risposta
• usare il token di accesso dell'utente destinatario per le chiamate API riportate di seguito
• far corrispondere sender nella regola push all'MXID completo dell'utente bot
• l'account destinatario deve già disporre di pusher funzionanti; le regole di anteprima silenziosa funzionano solo quando la normale distribuzione push di Matrix è operativa

Passaggi

{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"

Per rimuovere la regola in seguito, eseguire DELETE sullo stesso URL della regola con il token del destinatario.

Note sull'uso di più bot

Le regole push sono identificate da ruleId: rieseguire PUT sullo stesso ID aggiorna una singola regola. Se più bot OpenClaw inviano notifiche allo stesso destinatario, creare una regola per ciascun bot con una corrispondenza del mittente distinta.

Le nuove regole override definite dall'utente vengono inserite prima delle regole di soppressione predefinite del server, quindi non è necessario alcun parametro di ordinamento aggiuntivo. La regola interessa solo le modifiche delle anteprime di solo testo che possono essere finalizzate sul posto; le risposte multimediali, i fallback per anteprime obsolete e i testi finali che attiverebbero le menzioni Matrix vengono invece distribuiti come normali messaggi che generano notifiche.

Note sull'homeserver

Contenuti correlati

• Configurazione del canale Matrix
• Concetti dello streaming