Règles de push Matrix pour les aperçus silencieux

Lorsque channels.matrix.streaming vaut "quiet", OpenClaw diffuse la réponse en modifiant sur place un unique événement d’aperçu. Les aperçus sont envoyés sous forme d’événements m.notice sans notification, et la modification finale est marquée avec content["com.openclaw.finalized_preview"] = true. Les clients Matrix n’émettent une notification lors de cette modification finale que si une règle de notification push propre à l’utilisateur correspond au marqueur. Cette page s’adresse aux opérateurs qui auto-hébergent Matrix et souhaitent installer cette règle pour chaque compte destinataire.

streaming: "progress" finalise ses brouillons par le même chemin ; la même règle se déclenche donc également pour les modifications finalisées en mode progression.

Si vous souhaitez uniquement le comportement de notification Matrix standard, utilisez streaming: "partial" ou désactivez la diffusion en continu. Consultez la configuration du canal Matrix.

Prérequis

• utilisateur destinataire = la personne qui doit recevoir la notification
• utilisateur bot = le compte Matrix d’OpenClaw qui envoie la réponse
• utilisez le jeton d’accès de l’utilisateur destinataire pour les appels d’API ci-dessous
• faites correspondre sender dans la règle de notification push avec le MXID complet de l’utilisateur bot
• le compte destinataire doit déjà disposer de services de notification push fonctionnels ; les règles d’aperçu silencieux ne fonctionnent que lorsque la distribution push Matrix normale est opérationnelle

Étapes

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

Pour supprimer ultérieurement la règle, envoyez une requête DELETE à la même URL de règle avec le jeton du destinataire.

Remarques sur l’utilisation de plusieurs bots

Les règles de notification push sont indexées par ruleId : répéter une requête PUT avec le même identifiant met à jour une seule règle. Si plusieurs bots OpenClaw doivent notifier le même destinataire, créez une règle par bot avec une correspondance d’expéditeur distincte.

Les nouvelles règles override définies par l’utilisateur sont insérées avant les règles de suppression par défaut du serveur ; aucun paramètre d’ordre supplémentaire n’est donc nécessaire. La règle ne concerne que les modifications d’aperçus textuels pouvant être finalisées sur place ; les réponses multimédias, les mécanismes de repli pour les aperçus obsolètes et les textes finaux qui activeraient des mentions Matrix sont envoyés à la place comme des messages normaux déclenchant une notification.

Remarques sur les serveurs d’accueil

Pages associées

• Configuration du canal Matrix
• Concepts de diffusion en continu