用於靜音預覽的 Matrix 推播規則

設定靜默預覽

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

如果沒有傳回任何推送器，請先修正此帳號的一般 Matrix 推送傳遞，再繼續。

安裝覆寫推送規則

OpenClaw 會以 content["com.openclaw.finalized_preview"] = true 標記已最終化的純文字預覽編輯。安裝一條規則，比對該標記以及作為傳送者的機器人 MXID：

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 }
]
}'

執行前請替換：

• https://matrix.example.org：你的家伺服器基底 URL
• $USER_ACCESS_TOKEN：接收者使用者的存取權杖
• openclaw-finalized-preview-botname：每個機器人、每個接收者都唯一的規則 ID（模式：openclaw-finalized-preview-<botname>）
• @bot:example.org：你的 OpenClaw 機器人 MXID，不是接收者的

驗證

curl -sS \
-H "Authorization: Bearer $USER_ACCESS_TOKEN" \
"https://matrix.example.org/_matrix/client/v3/pushrules/global/override/openclaw-finalized-preview-botname"

接著測試串流回覆。在靜默模式中，房間會顯示靜默草稿預覽，並在區塊或回合完成時通知一次。