Matrix-pushregels voor stille voorbeelden

Wanneer channels.matrix.streaming is ingesteld op "quiet", streamt OpenClaw het antwoord door één voorbeeldgebeurtenis ter plekke te bewerken. Voorbeelden worden verzonden als niet-meldende m.notice-gebeurtenissen en de definitieve bewerking wordt gemarkeerd met content["com.openclaw.finalized_preview"] = true. Matrix-clients geven 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 account van een ontvanger willen installeren.

streaming: "progress" rondt concepten via hetzelfde pad af, zodat dezelfde regel ook wordt geactiveerd voor definitieve bewerkingen in de voortgangsmodus.

Als u alleen het standaardmeldingsgedrag van Matrix wilt, gebruikt u streaming: "partial" of schakelt u streaming uit. Zie Matrix-kanaal instellen.

Vereisten

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

Stappen

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

Als u de regel later wilt verwijderen, voert u een DELETE uit op dezelfde regel-URL met het token van de ontvanger.

Opmerkingen voor meerdere bots

Pushregels worden geïdentificeerd door ruleId: als u PUT opnieuw uitvoert met dezelfde ID, wordt één regel bijgewerkt. Als meerdere OpenClaw-bots dezelfde ontvanger meldingen sturen, maakt u voor elke bot één regel met een afzonderlijke afzenderovereenkomst.

Nieuwe, door gebruikers gedefinieerde override-regels worden vóór de standaardonderdrukkingsregels van de server ingevoegd, zodat geen aanvullende ordeningsparameter nodig is. De regel is alleen van invloed op uitsluitend tekst bevattende voorbeeldbewerkingen die ter plekke kunnen worden afgerond; media-antwoorden, terugvalopties voor verouderde voorbeelden en definitieve teksten die Matrix-vermeldingen zouden activeren, worden in plaats daarvan als normale meldingsberichten bezorgd.

Opmerkingen voor homeservers

Gerelateerd

• Matrix-kanaal instellen
• Streamingconcepten