Quy tắc đẩy lên Matrix cho bản xem trước không thông báo

Khi channels.matrix.streaming là "quiet", OpenClaw truyền phát câu trả lời bằng cách chỉnh sửa tại chỗ một sự kiện xem trước duy nhất. Các bản xem trước được gửi dưới dạng sự kiện m.notice không kích hoạt thông báo, và bản chỉnh sửa hoàn tất được đánh dấu bằng content["com.openclaw.finalized_preview"] = true. Các ứng dụng khách Matrix chỉ thông báo về bản chỉnh sửa cuối cùng đó nếu quy tắc đẩy riêng cho từng người dùng khớp với dấu mốc này. Trang này dành cho các đơn vị vận hành tự lưu trữ Matrix và muốn cài đặt quy tắc đó cho từng tài khoản người nhận.

streaming: "progress" hoàn tất các bản nháp qua cùng một đường dẫn, vì vậy quy tắc này cũng được kích hoạt cho các bản chỉnh sửa đã hoàn tất ở chế độ tiến trình.

Nếu bạn chỉ muốn hành vi thông báo Matrix mặc định, hãy dùng streaming: "partial" hoặc tắt tính năng truyền phát. Xem Thiết lập kênh Matrix.

Điều kiện tiên quyết

• người dùng nhận = người cần nhận thông báo
• người dùng bot = tài khoản Matrix của OpenClaw gửi câu trả lời
• dùng mã thông báo truy cập của người dùng nhận cho các lệnh gọi API bên dưới
• đối chiếu sender trong quy tắc đẩy với MXID đầy đủ của người dùng bot
• tài khoản người nhận phải có các trình đẩy đang hoạt động; quy tắc xem trước im lặng chỉ hoạt động khi cơ chế gửi thông báo đẩy Matrix thông thường đang ổn định

Các bước

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

Để xóa quy tắc sau này, hãy gửi DELETE đến cùng URL quy tắc bằng mã thông báo của người nhận.

Lưu ý khi dùng nhiều bot

Các quy tắc đẩy được định danh bằng ruleId: chạy lại PUT với cùng một ID sẽ cập nhật một quy tắc duy nhất. Với nhiều bot OpenClaw gửi thông báo cho cùng một người nhận, hãy tạo một quy tắc cho mỗi bot với điều kiện khớp người gửi riêng biệt.

Các quy tắc override mới do người dùng định nghĩa được chèn trước các quy tắc chặn mặc định của máy chủ, vì vậy không cần tham số thứ tự bổ sung. Quy tắc này chỉ ảnh hưởng đến các bản chỉnh sửa xem trước chỉ chứa văn bản có thể được hoàn tất tại chỗ; câu trả lời chứa nội dung đa phương tiện, phương án dự phòng khi bản xem trước đã cũ và văn bản cuối cùng có thể kích hoạt lượt nhắc đến trong Matrix sẽ được gửi dưới dạng thông báo thông thường.

Lưu ý về máy chủ nhà

Liên quan

• Thiết lập kênh Matrix
• Các khái niệm về truyền phát