静かなプレビュー向けのMatrixプッシュルール

quiet プレビューを設定する

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

pusher が存在することを確認する

curl -sS \
-H "Authorization: Bearer $USER_ACCESS_TOKEN" \
"https://matrix.example.org/_matrix/client/v3/pushers"

pusher が返ってこない場合は、続行する前にこのアカウントの通常の Matrix プッシュ配信を修正してください。

override プッシュルールをインストールする

OpenClaw は、確定したテキストのみのプレビュー編集に content["com.openclaw.finalized_preview"] = true を付けます。そのマーカーと、送信者としての bot 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: bot ごと、受信者ごとに一意のルール ID（パターン: openclaw-finalized-preview-<botname>）
• @bot:example.org: OpenClaw bot の MXID。受信者のものではありません

確認する

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

その後、ストリーミングされた返信をテストします。quiet モードでは、ルームに quiet ドラフトプレビューが表示され、ブロックまたはターンが完了した時点で一度だけ通知されます。