Les règles de notification Matrix d’OpenClaw pour les aperçus discrets

La diffusion discrète résout la moitié du problème de notifications de Matrix : le bot cesse de sonner à chaque modification. L’autre moitié est côté serveur, parce que seule une règle de notification sur le compte du destinataire peut dire quelle modification mérite une notification. Cette page s’adresse aux opérateurs qui auto-hébergent Synapse ou Tuwunel et veulent installer cette règle pour chaque destinataire. Voici le mécanisme, les étapes, la règle pour plusieurs bots, et les deux notes de serveur.

Le mécanisme

• Avec le mode de diffusion réglé sur discret, OpenClaw diffuse la réponse en modifiant sur place un seul événement d’aperçu ; les aperçus sont envoyés comme événements de notice sans notification, la modification finalisée porte une propriété OpenClaw d’aperçu finalisé, et les clients ne notifient sur cette modification finale que si une règle de notification par utilisateur correspond au marqueur.
• Le mode progress finalise ses brouillons par le même chemin, si bien que la même règle se déclenche aussi pour les modifications finalisées du mode progress, et les opérateurs qui ne veulent que le comportement de notification standard utilisent le mode partial ou laissent la diffusion désactivée.
• Les prérequis sont un utilisateur destinataire qui doit recevoir la notification, l’utilisateur bot qui envoie la réponse, le jeton d’accès du destinataire pour les appels d’API, l’identifiant Matrix complet du bot comme correspondance d’expéditeur dans la règle, et un compte destinataire qui a déjà des pousseurs fonctionnels, parce que les règles d’aperçu discret ne fonctionnent que si la livraison normale des notifications est saine.
• Les étapes commencent par configurer le mode discret dans le bloc du canal et obtenir le jeton d’accès du destinataire, en réutilisant si possible un jeton de session client existant ou en en frappant un par une requête de connexion par mot de passe auprès du serveur, exporté pour les appels qui suivent.

Les règles de notification sont indexées par ruleId : relancer PUT sur le même identifiant met à jour une seule règle.

Installer la règle

Vérifiez les pousseurs par le point de terminaison des pousseurs sous le jeton du destinataire, et réparez la livraison normale des notifications de ce compte avant de continuer si aucun ne revient. Installez ensuite une règle de notification de surcharge sous un identifiant de règle unique par bot et par destinataire, selon le motif d’aperçu finalisé avec le nom du bot, dont les quatre conditions correspondent à un type d’événement de message de salon, à un type de relation de remplacement, à la propriété d’aperçu finalisé réglée sur vrai, et à l’expéditeur égal à l’identifiant complet du bot, avec des actions de notification, le réglage de son par défaut et la mise en évidence désactivée ; remplacez l’URL du serveur, le jeton, l’identifiant de règle et l’identifiant du bot, en vous rappelant que l’expéditeur est le bot et non le destinataire. Vérifiez en récupérant la même URL de règle, puis testez une réponse diffusée : en mode discret, le salon montre un brouillon d’aperçu discret et notifie une fois le bloc ou le tour terminé, et la règle se retire plus tard en supprimant la même URL avec le jeton du destinataire.

Plusieurs bots et serveurs

• Les règles de notification sont indexées par identifiant de règle, si bien que relancer l’installation sur le même identifiant met à jour une seule règle, et plusieurs bots OpenClaw qui notifient le même destinataire exigent une règle par bot avec une correspondance d’expéditeur distincte ; les nouvelles règles de surcharge définies par l’utilisateur sont insérées avant les règles de suppression par défaut du serveur, donc aucun paramètre d’ordre n’est nécessaire.
• La règle n’affecte que les modifications d’aperçu textuelles qui peuvent être finalisées sur place : les réponses avec médias, les replis d’aperçu périmé et les textes finaux qui activeraient des mentions Matrix sont livrés comme des messages normaux avec notification.
• Synapse n’exige aucun changement de configuration de serveur, seulement que le chemin des règles de notification atteigne Synapse à travers tout proxy ou toute disposition en workers et que le processus de poussée soit sain, et comme la règle utilise la condition de propriété d’événement ajoutée à Synapse en 2023, les anciennes versions acceptent l’appel d’installation mais ne correspondent jamais en silence, si bien qu’une modification finalisée qui ne notifie jamais signifie une mise à niveau ; Tuwunel suit le même flux sans configuration spécifique, et des notifications qui disparaissent pendant que l’utilisateur est actif ailleurs désignent son option de suppression des notifications sur appareil actif ajoutée en 1.4.2, qui supprime volontairement les notifications vers les autres appareils pendant qu’un appareil est actif.

OpenClaw sur Matrix est le billet du canal que cette règle sert, et Le comportement des messages Matrix dans OpenClaw le mode de diffusion discret qu’elle complète.

Une règle par destinataire, par bot

La conception garde la décision du côté du destinataire : le bot ne fait que marquer sa modification finale, et chaque personne installe une règle qui dit si ce marqueur doit sonner, par bot, et c’est pourquoi l’identifiant de règle porte le nom du bot. Comptes et serveurs Matrix dans OpenClaw couvre l’exécution de plusieurs comptes de bot sur un même serveur, et Le chiffrement Matrix dans OpenClaw la vérification qui garde ces comptes fiables.

Sur Diali

Matrix figure dans la liste des canaux connectables de Diali, aux côtés de WhatsApp, Telegram, Discord, Slack, Mattermost, des SMS et de la voix : le compte sur le serveur d’accueil et la liste d’autorisation des salons sont à vous, la passerelle est à nous. OpenClaw hébergé sur Diali est l’assistant et La sécurité chez Diali décrit la frontière qui s’applique à chaque canal connecté.

• Le mode discret marque la modification finale ; la règle du destinataire sonne dessus.
• Des pousseurs sains d’abord, puis la règle de surcharge.
• Un vieux Synapse accepte la règle et n’y correspond jamais.