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

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

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

ذو صلة

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