Mainstream messaging
조용한 미리보기를 위한 Matrix 푸시 규칙
channels.matrix.streaming.mode이 "quiet"이면 OpenClaw는 단일 미리보기 이벤트를 그 자리에서 편집하여 응답을 스트리밍합니다. 미리보기는 알림을 발생시키지 않는 m.notice 이벤트로 전송되며, 최종 편집에는 content["com.openclaw.finalized_preview"] = true 표시가 지정됩니다. Matrix 클라이언트는 사용자별 푸시 규칙이 이 표시와 일치하는 경우에만 해당 최종 편집에 대한 알림을 보냅니다. 이 페이지는 Matrix를 자체 호스팅하며 각 수신자 계정에 이 규칙을 설치하려는 운영자를 위한 것입니다.
streaming.mode: "progress"도 같은 경로를 통해 초안을 최종 확정하므로, 동일한 규칙이 진행 모드에서 최종 확정된 편집에도 적용됩니다.
기본 Matrix 알림 동작만 사용하려면 streaming.mode: "partial"을 사용하거나 스트리밍을 끈 상태로 두십시오. Matrix 채널 설정을 참조하십시오.
사전 요구 사항
- 수신자 사용자 = 알림을 받아야 하는 사람
- 봇 사용자 = 응답을 보내는 OpenClaw Matrix 계정
- 아래 API 호출에는 수신자 사용자의 액세스 토큰을 사용하십시오
- 푸시 규칙의
sender을 봇 사용자의 전체 MXID와 일치시키십시오 - 수신자 계정에는 이미 정상 작동하는 푸셔가 있어야 합니다. 일반 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"푸셔가 반환되지 않으면 계속하기 전에 이 계정의 일반 Matrix 푸시 전송을 수정하십시오.
재정의 푸시 규칙 설치
최종 확정된 미리보기 표시와 발신자인 봇 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"그런 다음 스트리밍 응답을 테스트하십시오. 조용한 모드에서는 방에 조용한 초안 미리보기가 표시되고 블록 또는 턴이 완료되면 알림이 전송됩니다.
나중에 규칙을 제거하려면 수신자의 토큰을 사용하여 동일한 규칙 URL에 DELETE하십시오.
다중 봇 참고 사항
푸시 규칙의 키는 ruleId입니다. 동일한 ID에 대해 PUT을 다시 실행하면 단일 규칙이 업데이트됩니다. 여러 OpenClaw 봇이 동일한 수신자에게 알림을 보내는 경우, 각각 고유한 발신자 일치 조건을 가진 봇별 규칙을 하나씩 만드십시오.
새로운 사용자 정의 override 규칙은 서버 기본 억제 규칙보다 앞에 삽입되므로 추가 순서 매개변수는 필요하지 않습니다. 이 규칙은 그 자리에서 최종 확정할 수 있는 텍스트 전용 미리보기 편집에만 영향을 줍니다. 미디어 응답, 오래된 미리보기 대체 경로 및 Matrix 멘션을 활성화하는 최종 텍스트는 대신 일반 알림 메시지로 전송됩니다.
홈서버 참고 사항
Synapse
특별한 homeserver.yaml 변경은 필요하지 않습니다. 일반 Matrix 알림이 이미 이 사용자에게 도달한다면 수신자 토큰과 위의 pushrules 호출이 주요 설정 단계입니다.
역방향 프록시 또는 워커 뒤에서 Synapse를 실행하는 경우 /_matrix/client/.../pushrules/이 Synapse에 올바르게 도달하는지 확인하십시오. 푸시 전송은 주 프로세스 또는 synapse.app.pusher / 구성된 푸셔 워커에서 처리됩니다. 이들이 정상인지 확인하십시오.
이 규칙은 2023년에 Synapse에 추가된 event_property_is 푸시 규칙 조건(MSC3758, 푸시 규칙 v1.10)을 사용합니다. 이전 Synapse 릴리스에서는 PUT pushrules/... 호출을 허용하지만 조건과 일치하지 않아도 아무 오류를 표시하지 않습니다. 최종 확정된 미리보기 편집에 대한 알림이 오지 않으면 Synapse를 업그레이드하십시오.
Tuwunel
Synapse와 동일한 절차를 따릅니다. 최종 확정된 미리보기 표시를 위한 Tuwunel 전용 구성은 필요하지 않습니다.
사용자가 다른 기기에서 활성 상태일 때 알림이 사라진다면 suppress_push_when_active이 활성화되어 있는지 확인하십시오. Tuwunel은 1.4.2(2025년 9월)에 이 옵션을 추가했으며, 한 기기가 활성 상태인 동안 다른 기기로 전송되는 푸시를 의도적으로 억제할 수 있습니다.
