قواعد دفع 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 باستخدام المعرّف نفسه إلى تحديث قاعدة واحدة. إذا كانت عدة بوتات OpenClaw ترسل إشعارات إلى المستلم نفسه، فأنشئ قاعدة لكل بوت مع مطابقة مميزة للمرسل.

تُدرج قواعد override الجديدة التي يحددها المستخدم قبل قواعد المنع الافتراضية للخادم، لذا لا حاجة إلى معامل ترتيب إضافي. لا تؤثر القاعدة إلا في تعديلات المعاينة النصية فقط التي يمكن إنهاؤها في موضعها؛ أما ردود الوسائط، وعمليات الرجوع الاحتياطي للمعاينات القديمة، والنصوص النهائية التي قد تفعّل إشارات Matrix، فتُسلَّم بدلًا من ذلك كرسائل عادية مُصدرة للإشعارات.

ملاحظات حول الخادم المنزلي

ذو صلة

• إعداد قناة Matrix
• مفاهيم البث