Regole di push di Matrix per anteprime silenziose

Quando channels.matrix.streaming è impostato su "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 definitiva viene contrassegnata con content["com.openclaw.finalized_preview"] = true. I client Matrix notificano tale modifica definitiva solo se una regola push specifica per utente corrisponde al contrassegno. Questa pagina è destinata agli operatori che ospitano autonomamente Matrix e desiderano installare tale regola per ciascun account destinatario.

streaming: "progress" finalizza le proprie bozze tramite lo stesso percorso, quindi la stessa regola si attiva anche per le modifiche definitive in modalità di avanzamento.

Se desideri soltanto il comportamento standard delle notifiche di Matrix, usa streaming: "partial" oppure disattiva lo streaming. Consulta 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
• usa il token di accesso dell'utente destinatario per le chiamate API riportate di seguito
• nella regola push, confronta sender con l'MXID completo dell'utente bot
• l'account destinatario deve già disporre di pusher funzionanti; le regole per le anteprime silenziose funzionano solo quando la normale consegna push di Matrix è operativa

Passaggi

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

Per rimuovere successivamente la regola, esegui DELETE sullo stesso URL della regola usando il token del destinatario.

Note per configurazioni con più bot

Le regole push sono identificate da ruleId: rieseguire PUT sullo stesso ID aggiorna una singola regola. Se più bot OpenClaw devono inviare notifiche allo stesso destinatario, crea una regola per ogni bot con una corrispondenza distinta per il mittente.

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 riguarda soltanto le modifiche delle anteprime di solo testo che possono essere finalizzate sul posto; le risposte multimediali, i fallback per anteprime obsolete e i testi definitivi che attiverebbero le menzioni di Matrix vengono invece consegnati come normali messaggi con notifica.

Note sull'homeserver

Contenuti correlati

• Configurazione del canale Matrix
• Concetti dello streaming