Règles de notification push Matrix pour des aperçus silencieux

Lorsque channels.matrix.streaming.mode vaut "quiet", OpenClaw diffuse la réponse en modifiant sur place un seul événement d’aperçu. Les aperçus sont envoyés sous forme d’événements m.notice sans notification, et la modification finalisée est marquée avec content["com.openclaw.finalized_preview"] = true. Les clients Matrix n’émettent une notification pour cette modification finale que si une règle de notification 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.mode: "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.mode: "partial" ou laissez la diffusion désactivée. 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 au MXID complet de l’utilisateur bot
• le compte destinataire doit déjà disposer de services de notification opérationnels ; les règles d’aperçu silencieux ne fonctionnent que lorsque l’envoi normal des notifications Matrix est opérationnel

Étapes

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

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

Remarques sur les configurations à plusieurs bots

Les règles de notification sont indexées par ruleId : réexécuter PUT avec le même ID met à jour une seule règle. Pour que plusieurs bots OpenClaw notifient 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 affecte uniquement les modifications d’aperçu ne contenant que du texte qui peuvent être finalisées sur place ; les réponses multimédias, les replis liés aux aperçus obsolètes et les textes finaux qui activeraient les mentions Matrix sont envoyés à la place comme des messages normaux avec notification.

Remarques sur les serveurs d’origine

Voir aussi

• Configuration du canal Matrix
• Concepts de diffusion