กฎการพุชของ Matrix สำหรับพรีวิวแบบเงียบ

เมื่อ channels.matrix.streaming เป็น "quiet" OpenClaw จะแก้ไขอีเวนต์ตัวอย่างเดียวในตำแหน่งเดิม และทำเครื่องหมายการแก้ไขที่เสร็จสมบูรณ์ด้วยแฟล็กเนื้อหาแบบกำหนดเอง ไคลเอนต์ Matrix จะแจ้งเตือนเมื่อมีการแก้ไขสุดท้ายก็ต่อเมื่อกฎการพุชรายผู้ใช้ตรงกับแฟล็กนั้น หน้านี้มีไว้สำหรับผู้ดูแลระบบที่โฮสต์ Matrix เองและต้องการติดตั้งกฎนั้นให้กับแต่ละบัญชีผู้รับ

หากคุณต้องการเพียงพฤติกรรมการแจ้งเตือน Matrix มาตรฐาน ให้ใช้ streaming: "partial" หรือปิดการสตรีมไว้ ดู การตั้งค่าช่องทาง Matrix

ข้อกำหนดเบื้องต้น

• ผู้ใช้ผู้รับ = บุคคลที่ควรได้รับการแจ้งเตือน
• ผู้ใช้บอต = บัญชี Matrix ของ OpenClaw ที่ส่งคำตอบ
• ใช้ access token ของผู้ใช้ผู้รับสำหรับการเรียก API ด้านล่าง
• จับคู่ sender ในกฎการพุชกับ MXID แบบเต็มของผู้ใช้บอต
• บัญชีผู้รับต้องมี pushers ที่ทำงานได้อยู่แล้ว — กฎตัวอย่างแบบเงียบจะทำงานเฉพาะเมื่อการส่งพุช 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"

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"

หากต้องการลบกฎในภายหลัง ให้ DELETE URL กฎเดียวกันด้วยโทเค็นของผู้รับ

หมายเหตุสำหรับหลายบอต

กฎการพุชถูกกำหนดคีย์ด้วย ruleId: การเรียก PUT ซ้ำกับ ID เดิมจะอัปเดตกฎเดียว สำหรับบอต OpenClaw หลายตัวที่แจ้งเตือนผู้รับคนเดียวกัน ให้สร้างกฎหนึ่งรายการต่อบอตโดยใช้การจับคู่ผู้ส่งที่แตกต่างกัน

กฎ override ที่ผู้ใช้กำหนดใหม่จะถูกแทรกไว้ก่อนกฎระงับค่าเริ่มต้น ดังนั้นจึงไม่ต้องใช้พารามิเตอร์การจัดลำดับเพิ่มเติม กฎนี้มีผลเฉพาะกับการแก้ไขตัวอย่างแบบข้อความล้วนที่สามารถทำให้เสร็จสมบูรณ์ในตำแหน่งเดิมได้เท่านั้น ส่วน fallback สำหรับสื่อและ fallback สำหรับตัวอย่างที่ค้างเก่าใช้การส่ง Matrix ปกติ

หมายเหตุสำหรับ homeserver

ที่เกี่ยวข้อง

• การตั้งค่าช่องทาง Matrix
• แนวคิดการสตรีม