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

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

streaming: "progress" ทำให้ฉบับร่างเสร็จสมบูรณ์ผ่านเส้นทางเดียวกัน ดังนั้นกฎเดียวกันนี้จึงทำงานกับการแก้ไขฉบับสมบูรณ์ในโหมดความคืบหน้าด้วย

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

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

• ผู้ใช้ผู้รับ = บุคคลที่ควรได้รับการแจ้งเตือน
• ผู้ใช้บอต = บัญชี Matrix ของ OpenClaw ที่ส่งคำตอบ
• ใช้โทเค็นการเข้าถึงของผู้ใช้ผู้รับสำหรับการเรียก API ด้านล่าง
• จับคู่ sender ในกฎพุชกับ MXID แบบเต็มของผู้ใช้บอต
• บัญชีผู้รับต้องมีตัวส่งการแจ้งเตือนที่ใช้งานได้อยู่แล้ว กฎตัวอย่างแบบเงียบจะทำงานเฉพาะเมื่อการส่งพุชตามปกติของ 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 ที่ผู้ใช้กำหนดขึ้นใหม่จะถูกแทรกไว้ก่อนกฎระงับเริ่มต้นของเซิร์ฟเวอร์ จึงไม่จำเป็นต้องมีพารามิเตอร์การจัดลำดับเพิ่มเติม กฎนี้มีผลเฉพาะกับการแก้ไขตัวอย่างที่เป็นข้อความล้วนและสามารถทำให้เสร็จสมบูรณ์ ณ ตำแหน่งเดิมได้ ส่วนคำตอบแบบสื่อ การย้อนกลับเมื่อตัวอย่างล้าสมัย และข้อความสุดท้ายที่จะเปิดใช้งานการกล่าวถึงของ Matrix จะถูกส่งเป็นข้อความแจ้งเตือนตามปกติแทน

หมายเหตุสำหรับโฮมเซิร์ฟเวอร์

เนื้อหาที่เกี่ยวข้อง

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