Reguły powiadomień push Matrix dla cichych podglądów

Gdy channels.matrix.streaming.mode ma wartość "quiet", OpenClaw przesyła strumieniowo odpowiedź, edytując w miejscu jedno zdarzenie podglądu. Podglądy są wysyłane jako niewywołujące powiadomień zdarzenia m.notice, a ukończona edycja jest oznaczana za pomocą content["com.openclaw.finalized_preview"] = true. Klienty Matrix powiadamiają o tej końcowej edycji tylko wtedy, gdy reguła powiadomień użytkownika pasuje do znacznika. Ta strona jest przeznaczona dla operatorów samodzielnie hostujących Matrix, którzy chcą zainstalować tę regułę dla każdego konta odbiorcy.

streaming.mode: "progress" finalizuje swoje wersje robocze tą samą ścieżką, dlatego ta sama reguła jest również wyzwalana dla ukończonych edycji w trybie postępu.

Aby korzystać wyłącznie ze standardowego działania powiadomień Matrix, należy użyć streaming.mode: "partial" lub pozostawić przesyłanie strumieniowe wyłączone. Zobacz konfigurację kanału Matrix.

Wymagania wstępne

• użytkownik odbiorcy = osoba, która powinna otrzymać powiadomienie
• użytkownik bota = konto OpenClaw w Matrix, które wysyła odpowiedź
• w poniższych wywołaniach API należy użyć tokenu dostępu użytkownika odbiorcy
• wartość sender w regule powiadomień należy dopasować do pełnego identyfikatora MXID użytkownika bota
• konto odbiorcy musi już mieć działające mechanizmy pusher; reguły cichych podglądów działają tylko wtedy, gdy standardowe dostarczanie powiadomień push Matrix działa prawidłowo

Kroki

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

Aby później usunąć regułę, należy wykonać DELETE dla tego samego adresu URL reguły przy użyciu tokenu odbiorcy.

Uwagi dotyczące wielu botów

Kluczem reguł powiadomień jest ruleId: ponowne wykonanie PUT dla tego samego identyfikatora aktualizuje jedną regułę. Jeśli wiele botów OpenClaw ma powiadamiać tego samego odbiorcę, należy utworzyć osobną regułę dla każdego bota z odrębnym dopasowaniem nadawcy.

Nowe reguły użytkownika override są wstawiane przed domyślnymi regułami serwera wyciszającymi powiadomienia, dlatego dodatkowy parametr kolejności nie jest potrzebny. Reguła wpływa wyłącznie na tekstowe edycje podglądu, które można ukończyć w miejscu; odpowiedzi z multimediami, mechanizmy awaryjne dla nieaktualnego podglądu oraz teksty końcowe, które aktywowałyby wzmianki Matrix, są zamiast tego dostarczane jako zwykłe wiadomości wywołujące powiadomienia.

Uwagi dotyczące serwera domowego

Powiązane

• Konfiguracja kanału Matrix
• Pojęcia dotyczące przesyłania strumieniowego