Matrix-Push-Regeln für stille Vorschauen

Wenn channels.matrix.streaming.mode auf "quiet" gesetzt ist, streamt OpenClaw die Antwort, indem ein einzelnes Vorschauereignis direkt bearbeitet wird. Vorschauen werden als nicht benachrichtigende m.notice-Ereignisse gesendet, und die abschließende Bearbeitung wird mit content["com.openclaw.finalized_preview"] = true gekennzeichnet. Matrix-Clients benachrichtigen bei dieser abschließenden Bearbeitung nur, wenn eine benutzerspezifische Push-Regel auf die Markierung zutrifft. Diese Seite richtet sich an Betreiber, die Matrix selbst hosten und diese Regel für jedes Empfängerkonto installieren möchten.

streaming.mode: "progress" schließt seine Entwürfe über denselben Pfad ab, sodass dieselbe Regel auch bei abgeschlossenen Bearbeitungen im Fortschrittsmodus ausgelöst wird.

Wenn Sie nur das standardmäßige Benachrichtigungsverhalten von Matrix wünschen, verwenden Sie streaming.mode: "partial" oder lassen Sie das Streaming deaktiviert. Siehe Einrichtung des Matrix-Kanals.

Voraussetzungen

• Empfängerbenutzer = die Person, die die Benachrichtigung erhalten soll
• Bot-Benutzer = das OpenClaw-Matrix-Konto, das die Antwort sendet
• verwenden Sie für die folgenden API-Aufrufe das Zugriffstoken des Empfängerbenutzers
• gleichen Sie sender in der Push-Regel mit der vollständigen MXID des Bot-Benutzers ab
• für das Empfängerkonto müssen bereits funktionsfähige Pusher vorhanden sein; Regeln für stille Vorschauen funktionieren nur, wenn die normale Matrix-Push-Zustellung fehlerfrei arbeitet

Schritte

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

Um die Regel später zu entfernen, führen Sie DELETE für dieselbe Regel-URL mit dem Token des Empfängers aus.

Hinweise zu mehreren Bots

Push-Regeln werden anhand von ruleId identifiziert: Wenn PUT erneut mit derselben ID ausgeführt wird, wird eine einzelne Regel aktualisiert. Wenn mehrere OpenClaw-Bots denselben Empfänger benachrichtigen, erstellen Sie für jeden Bot eine eigene Regel mit einem eindeutigen Absenderabgleich.

Neue benutzerdefinierte override-Regeln werden vor den standardmäßigen Unterdrückungsregeln des Servers eingefügt, sodass kein zusätzlicher Reihenfolgeparameter erforderlich ist. Die Regel betrifft nur reine Textbearbeitungen von Vorschauen, die direkt abgeschlossen werden können. Medienantworten, Ausweichzustellungen für veraltete Vorschauen und endgültige Texte, die Matrix-Erwähnungen auslösen würden, werden stattdessen als normale Nachrichten mit Benachrichtigung zugestellt.

Hinweise zum Homeserver

Verwandte Themen

• Einrichtung des Matrix-Kanals
• Streaming-Konzepte