กฎการพุชของ 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

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

• ผู้รับ = บุคคลที่ควรได้รับการแจ้งเตือน
• ผู้ใช้บอต = บัญชี Matrix ของ OpenClaw ที่ส่งการตอบกลับ
• ใช้โทเค็นการเข้าถึงของผู้รับสำหรับการเรียก 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"

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
• แนวคิดเกี่ยวกับการสตรีม