Matrix-pushregels voor stille voorvertoningen

Wanneer channels.matrix.streaming.mode "quiet" is, streamt OpenClaw het antwoord door één voorbeeldgebeurtenis ter plaatse te bewerken. Voorbeelden worden als niet-meldende m.notice-gebeurtenissen verzonden en de voltooide bewerking wordt gemarkeerd met content["com.openclaw.finalized_preview"] = true. Matrix-clients sturen bij die definitieve bewerking alleen een melding als een pushregel per gebruiker overeenkomt met de markering. Deze pagina is bedoeld voor beheerders die Matrix zelf hosten en die regel voor elk ontvangend account willen installeren.

streaming.mode: "progress" voltooit concepten via hetzelfde pad, zodat dezelfde regel ook wordt geactiveerd voor voltooide bewerkingen in de voortgangsmodus.

Als je alleen het standaardmeldingsgedrag van Matrix wilt, gebruik je streaming.mode: "partial" of laat je streaming uitgeschakeld. Zie Matrix-kanaal instellen.

Vereisten

• ontvangende gebruiker = de persoon die de melding moet ontvangen
• botgebruiker = het OpenClaw Matrix-account dat het antwoord verzendt
• gebruik voor de onderstaande API-aanroepen het toegangstoken van de ontvangende gebruiker
• laat sender in de pushregel overeenkomen met de volledige MXID van de botgebruiker
• het ontvangende account moet al werkende pushers hebben; regels voor stille voorbeelden werken alleen als de normale pushbezorging van Matrix goed functioneert

Stappen

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

Om de regel later te verwijderen, DELETE je dezelfde regel-URL met het token van de ontvanger.

Opmerkingen voor meerdere bots

Pushregels worden geïndexeerd op ruleId: als je PUT opnieuw uitvoert voor dezelfde ID, wordt één regel bijgewerkt. Als meerdere OpenClaw-bots dezelfde ontvanger meldingen sturen, maak je per bot één regel met een afzonderlijke overeenkomst voor de afzender.

Nieuwe door gebruikers gedefinieerde override-regels worden vóór de standaardonderdrukkingsregels van de server ingevoegd, zodat er geen extra parameter voor de volgorde nodig is. De regel heeft alleen invloed op tekstuele voorbeeldbewerkingen die ter plaatse kunnen worden voltooid; media-antwoorden, terugvallen voor verouderde voorbeelden en definitieve teksten die Matrix-vermeldingen zouden activeren, worden in plaats daarvan als normale berichten met meldingen bezorgd.

Opmerkingen voor homeservers

Gerelateerd

• Matrix-kanaal instellen
• Streamingconcepten