조용한 미리보기를 위한 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 푸시 전달을 수정하세요.

override 푸시 규칙 설치

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: 수신자의 MXID가 아니라 OpenClaw 봇 MXID

확인

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

그런 다음 스트리밍 답장을 테스트하세요. quiet 모드에서는 방에 조용한 초안 미리 보기가 표시되고, 블록 또는 턴이 끝나면 한 번 알림을 보냅니다.