Matrix-Push-Regeln für unaufdringliche Vorschauen

Wenn channels.matrix.streaming auf "quiet" gesetzt ist, streamt OpenClaw die Antwort, indem es ein einzelnes Vorschauereignis direkt aktualisiert. Vorschauen werden als nicht benachrichtigende m.notice-Ereignisse gesendet, und die abschließende Bearbeitung wird mit content["com.openclaw.finalized_preview"] = true markiert. 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: "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: "partial" oder lassen Sie 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 funktionierende Pusher vorhanden sein; Regeln für stille Vorschauen funktionieren nur, wenn die normale Matrix-Push-Zustellung ordnungsgemäß funktioniert

Schritte

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

Um die Regel später zu entfernen, senden Sie mit dem Token des Empfängers eine DELETE-Anfrage an dieselbe Regel-URL.

Hinweise zu mehreren Bots

Push-Regeln werden nach 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 individuellen 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 wirkt sich nur auf reine Textvorschau-Bearbeitungen aus, die direkt abgeschlossen werden können. Medienantworten, Ausweichvorgänge bei veralteten Vorschauen und endgültige Texte, die Matrix-Erwähnungen aktivieren würden, werden stattdessen als normale benachrichtigende Nachrichten zugestellt.

Hinweise zum Homeserver

Verwandte Themen

• Einrichtung des Matrix-Kanals
• Streaming-Konzepte