Zum Hauptinhalt springen

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Wenn channels.matrix.streaming auf "quiet" gesetzt ist, bearbeitet OpenClaw ein einzelnes Vorschauereignis direkt und kennzeichnet die finalisierte Bearbeitung mit einem benutzerdefinierten Inhalts-Flag. Matrix-Clients benachrichtigen nur dann über die finale Bearbeitung, wenn eine benutzerspezifische Push-Regel dieses Flag abgleicht. Diese Seite richtet sich an Betreiber, die Matrix selbst hosten und diese Regel für jedes Empfängerkonto installieren möchten. Wenn Sie nur das Standard-Benachrichtigungsverhalten von Matrix möchten, 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 das Access Token des Empfängerbenutzers für die folgenden API-Aufrufe
  • gleichen Sie sender in der Push-Regel mit der vollständigen MXID des Bot-Benutzers ab
  • das Empfängerkonto muss bereits funktionierende Pusher haben — Regeln für stille Vorschauen funktionieren nur, wenn die normale Matrix-Push-Zustellung fehlerfrei läuft

​
Schritte

1

Stille Vorschauen konfigurieren

{
  channels: {
    matrix: {
      streaming: "quiet",
    },
  },
}
2

Access Token des Empfängers abrufen

Verwenden Sie nach Möglichkeit ein vorhandenes Client-Sitzungstoken erneut. So erstellen Sie ein neues:
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"
  }'
3

Vorhandene Pusher prüfen

curl -sS \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  "https://matrix.example.org/_matrix/client/v3/pushers"
Wenn keine Pusher zurückkommen, beheben Sie die normale Matrix-Push-Zustellung für dieses Konto, bevor Sie fortfahren.
4

Override-Push-Regel installieren

OpenClaw kennzeichnet finalisierte reine Text-Vorschau-Bearbeitungen mit content["com.openclaw.finalized_preview"] = true. Installieren Sie eine Regel, die diesen Marker plus die Bot-MXID als Absender abgleicht:
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 }
    ]
  }'
Vor dem Ausführen ersetzen:
  • https://matrix.example.org: die Basis-URL Ihres Homeservers
  • $USER_ACCESS_TOKEN: das Access Token des Empfängerbenutzers
  • openclaw-finalized-preview-botname: eine pro Bot und Empfänger eindeutige Regel-ID (Muster: openclaw-finalized-preview-<botname>)
  • @bot:example.org: die MXID Ihres OpenClaw-Bots, nicht die des Empfängers
5

Prüfen

curl -sS \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  "https://matrix.example.org/_matrix/client/v3/pushrules/global/override/openclaw-finalized-preview-botname"
Testen Sie anschließend eine gestreamte Antwort. Im stillen Modus zeigt der Raum eine stille Entwurfsvorschau und benachrichtigt einmal, wenn der Block oder Turn abgeschlossen ist.
Um die Regel später zu entfernen, senden Sie DELETE an dieselbe Regel-URL mit dem Token des Empfängers.

​
Hinweise zu mehreren Bots

Push-Regeln werden durch ruleId identifiziert: Ein erneutes Ausführen von PUT mit derselben ID aktualisiert eine einzelne Regel. Wenn mehrere OpenClaw-Bots denselben Empfänger benachrichtigen, erstellen Sie pro Bot eine Regel mit einem eigenen Absenderabgleich. Neue benutzerdefinierte override-Regeln werden vor den standardmäßigen Unterdrückungsregeln eingefügt, daher ist kein zusätzlicher Ordnungsparameter erforderlich. Die Regel betrifft nur reine Text-Vorschau-Bearbeitungen, die direkt finalisiert werden können; Medien-Fallbacks und Fallbacks für veraltete Vorschauen verwenden die normale Matrix-Zustellung.

​
Hinweise zum Homeserver

Es ist keine spezielle Änderung an homeserver.yaml erforderlich. Wenn normale Matrix-Benachrichtigungen diesen Benutzer bereits erreichen, ist das Empfängertoken plus der oben gezeigte pushrules-Aufruf der wichtigste Einrichtungsschritt.Wenn Sie Synapse hinter einem Reverse Proxy oder mit Workern betreiben, stellen Sie sicher, dass /_matrix/client/.../pushrules/ Synapse korrekt erreicht. Die Push-Zustellung wird vom Hauptprozess oder von synapse.app.pusher / konfigurierten Pusher-Workern verarbeitet — stellen Sie sicher, dass diese fehlerfrei laufen.Die Regel verwendet die Push-Regel-Bedingung event_property_is (MSC3758, Push-Regel v1.10), die 2023 zu Synapse hinzugefügt wurde. Ältere Synapse-Versionen akzeptieren den Aufruf PUT pushrules/..., gleichen die Bedingung jedoch stillschweigend nie ab — aktualisieren Sie Synapse, wenn bei einer finalisierten Vorschau-Bearbeitung keine Benachrichtigung eintrifft.
Gleicher Ablauf wie bei Synapse; für den finalisierten Vorschau-Marker ist keine Tuwunel-spezifische Konfiguration erforderlich.Wenn Benachrichtigungen verschwinden, während der Benutzer auf einem anderen Gerät aktiv ist, prüfen Sie, ob suppress_push_when_active aktiviert ist. Tuwunel hat diese Option in 1.4.2 (September 2025) hinzugefügt, und sie kann Pushes an andere Geräte absichtlich unterdrücken, während ein Gerät aktiv ist.

​
Verwandte Themen