Matrix-Push-Regeln für stille Vorschauen in OpenClaw

Quiet-Streaming löst die Hälfte des Benachrichtigungsproblems von Matrix: Der Bot klingelt nicht mehr bei jeder Bearbeitung. Die andere Hälfte liegt auf der Seite des Homeservers, denn nur eine Push-Regel im Konto des Empfängers kann festlegen, welche Bearbeitung eine Benachrichtigung verdient. Diese Seite richtet sich an Betreiber, die Synapse oder Tuwunel selbst hosten und diese Regel für jeden Empfänger installieren wollen. Hier sind der Mechanismus, die Schritte, die Regel für mehrere Bots und die beiden Homeserver-Hinweise.

Der Mechanismus

• Ist der Streaming-Modus auf quiet gesetzt, streamt OpenClaw die Antwort, indem es ein einzelnes Vorschau-Event an Ort und Stelle bearbeitet; Vorschauen werden als nicht benachrichtigende Notice-Events gesendet, die finale Bearbeitung wird mit einer OpenClaw-Eigenschaft für finalisierte Vorschauen markiert, und Clients benachrichtigen bei dieser finalen Bearbeitung nur, wenn eine Push-Regel pro Nutzer auf die Markierung passt.
• Der Progress-Modus finalisiert seine Entwürfe über denselben Weg, sodass dieselbe Regel auch bei finalisierten Bearbeitungen im Progress-Modus greift; Betreiber, die nur das Standard-Benachrichtigungsverhalten wollen, nutzen den Partial-Modus oder lassen Streaming ausgeschaltet.
• Die Voraussetzungen sind ein Empfänger-Nutzer, der die Benachrichtigung erhalten soll, der Bot-Nutzer, der die Antwort sendet, das Access-Token des Empfängers für die API-Aufrufe, die vollständige Matrix-ID des Bots als Absender-Kriterium in der Regel und ein Empfängerkonto, das bereits funktionierende Pusher hat, denn Regeln für stille Vorschauen funktionieren nur, wenn die normale Push-Zustellung intakt ist.
• Die Schritte beginnen damit, den Quiet-Modus im Kanalblock zu konfigurieren und das Access-Token des Empfängers zu beschaffen: Verwenden Sie nach Möglichkeit ein vorhandenes Sitzungstoken eines Clients wieder oder erzeugen Sie per Passwort-Login-Anfrage an den Homeserver ein neues, und exportieren Sie es für die folgenden Aufrufe.

Push-Regeln werden über ruleId identifiziert: Ein erneuter PUT gegen dieselbe ID aktualisiert eine einzige Regel.

Die Regel installieren

Prüfen Sie die Pusher über den Pushers-Endpunkt mit dem Token des Empfängers, und reparieren Sie die normale Push-Zustellung für dieses Konto, bevor Sie fortfahren, falls keine zurückkommen. Installieren Sie dann eine Override-Push-Regel unter einer Regel-ID, die pro Bot und pro Empfänger eindeutig ist und dem Muster für finalisierte Vorschauen mit dem Namen des Bots folgt; ihre vier Bedingungen prüfen auf den Event-Typ Raumnachricht, den Relationstyp replace, die auf true gesetzte Eigenschaft für finalisierte Vorschauen und einen Absender, der der vollständigen ID des Bots entspricht, mit den Aktionen notify, dem Standard-Sound-Tweak und ausgeschaltetem Highlight. Ersetzen Sie die Homeserver-URL, das Token, die Regel-ID und die Bot-ID, und denken Sie daran, dass der Absender der Bot ist und nicht der Empfänger. Prüfen Sie das Ergebnis, indem Sie dieselbe Regel-URL abrufen, und testen Sie dann eine gestreamte Antwort: Im Quiet-Modus zeigt der Raum eine stille Entwurfsvorschau und benachrichtigt, sobald der Block oder Turn abgeschlossen ist; später entfernen Sie die Regel, indem Sie dieselbe URL mit dem Token des Empfängers löschen.

Mehrere Bots und Homeserver

• Push-Regeln werden über die Regel-ID identifiziert, sodass eine erneute Installation gegen dieselbe ID eine einzige Regel aktualisiert, und mehrere OpenClaw-Bots, die denselben Empfänger benachrichtigen, brauchen eine Regel pro Bot mit jeweils eigenem Absender-Kriterium; neue benutzerdefinierte Override-Regeln werden vor den standardmäßigen Suppress-Regeln des Servers eingefügt, sodass kein Parameter für die Reihenfolge nötig ist.
• Die Regel betrifft nur reine Text-Bearbeitungen von Vorschauen, die an Ort und Stelle finalisiert werden können: Antworten mit Medien, Fallbacks bei veralteter Vorschau und finale Texte, die Matrix-Erwähnungen auslösen würden, werden stattdessen als normale, benachrichtigende Nachrichten zugestellt.
• Synapse braucht keine Änderung an der Homeserver-Konfiguration, nur muss der Push-Rules-Pfad Synapse durch jede Proxy- oder Worker-Anordnung erreichen und der Pusher-Prozess intakt sein; und weil die Regel die Bedingung event-property-is nutzt, die Synapse 2023 hinzugefügt wurde, akzeptieren ältere Releases den Installationsaufruf, treffen aber stillschweigend nie, sodass eine finalisierte Bearbeitung, die nie benachrichtigt, ein Upgrade bedeutet. Tuwunel folgt demselben Ablauf ohne spezielle Konfiguration, und Benachrichtigungen, die verschwinden, während der Nutzer anderswo aktiv ist, deuten auf seine in 1.4.2 hinzugefügte Option suppress-push-when-active hin, die Pushes an andere Geräte absichtlich unterdrückt, solange eines aktiv ist.

OpenClaw auf Matrix ist der Kanal-Beitrag, dem diese Regel dient, und den Quiet-Streaming-Modus, den sie vervollständigt, finden Sie unter Nachrichtenverhalten von OpenClaw auf Matrix.

Eine Regel pro Empfänger und pro Bot

Das Design belässt die Entscheidung auf der Seite des Empfängers: Der Bot markiert nur seine finale Bearbeitung, und jede Person installiert pro Bot eine Regel, die festlegt, ob diese Markierung klingeln soll; deshalb trägt die Regel-ID den Namen des Bots. Matrix-Konten und Homeserver in OpenClaw behandelt den Betrieb mehrerer Bot-Konten auf einem Homeserver, und Matrix-Verschlüsselung in OpenClaw die Verifizierung, die diese Konten vertrauenswürdig hält.

Auf Diali

Matrix steht auf der Liste der Kanäle, die Sie mit Diali verbinden können, neben WhatsApp, Telegram, Discord, Slack, Mattermost, SMS und Sprachanrufen: Das Homeserver-Konto und die Raum-Zulassungsliste gehören Ihnen, das Gateway gehört uns. Gehostetes OpenClaw auf Diali ist der Assistent, und Sicherheit bei Diali beschreibt die Grenze, die für jeden verbundenen Kanal gilt.

• Der Quiet-Modus markiert die finale Bearbeitung; die Regel des Empfängers lässt es dabei klingeln.
• Erst funktionierende Pusher, dann die Override-Regel.
• Ein altes Synapse akzeptiert die Regel und trifft sie nie.