Правила push-уведомлений Matrix для ненавязчивых предпросмотров

Когда channels.matrix.streaming.mode имеет значение "quiet", OpenClaw передаёт ответ потоково, редактируя одно событие предварительного просмотра на месте. Предварительные версии отправляются как события m.notice без уведомлений, а итоговое редактирование помечается маркером content["com.openclaw.finalized_preview"] = true. Клиенты Matrix уведомляют только об этом итоговом редактировании и только в том случае, если пользовательское правило push-уведомлений соответствует маркеру. Эта страница предназначена для операторов, самостоятельно размещающих Matrix и желающих установить такое правило для каждой учётной записи получателя.

streaming.mode: "progress" завершает свои черновики тем же способом, поэтому это же правило срабатывает и для итоговых редактирований в режиме отображения прогресса.

Если вам достаточно стандартного поведения уведомлений Matrix, используйте streaming.mode: "partial" или отключите потоковую передачу. См. раздел Настройка канала Matrix.

Предварительные требования

• пользователь-получатель = человек, который должен получить уведомление
• пользователь-бот = учётная запись OpenClaw в Matrix, отправляющая ответ
• для приведённых ниже вызовов API используйте токен доступа пользователя-получателя
• в правиле push-уведомлений сопоставляйте sender с полным MXID пользователя-бота
• для учётной записи получателя уже должны работать механизмы доставки push-уведомлений; правила тихого предварительного просмотра работают только при исправной обычной доставке push-уведомлений Matrix

Шаги

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

Чтобы позднее удалить правило, выполните DELETE для того же URL правила с токеном получателя.

Примечания о нескольких ботах

Правила push-уведомлений индексируются по ruleId: повторное выполнение PUT с тем же идентификатором обновляет одно правило. Если несколько ботов OpenClaw уведомляют одного получателя, создайте отдельное правило для каждого бота с отдельным условием сопоставления отправителя.

Новые пользовательские правила override вставляются перед стандартными серверными правилами подавления, поэтому дополнительный параметр порядка не требуется. Правило влияет только на текстовые редактирования предварительного просмотра, которые можно завершить на месте; ответы с медиафайлами, резервные варианты для устаревших предварительных версий и итоговые тексты, которые активировали бы упоминания Matrix, вместо этого доставляются как обычные сообщения с уведомлениями.

Примечания о домашнем сервере

Связанные материалы

• Настройка канала Matrix
• Основные понятия потоковой передачи