يمكن لـ OpenClaw إرفاق بيانات وصفية موحّدة من نوعDocumentation Index
Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
MessagePresentation بأحداث Matrix الصادرة من نوع m.room.message ضمن com.openclaw.presentation.
يستمر عملاء Matrix القياسيون في عرض النص العادي في body. ويمكن للعملاء المتوافقين مع OpenClaw قراءة البيانات الوصفية المنظمة وعرض واجهة مستخدم أصلية مثل الأزرار، وقوائم الاختيار، وصفوف السياق، والفواصل.
محتوى الحدث
تُخزَّن البيانات الوصفية في محتوى حدث Matrix:version هو إصدار مخطط بيانات عرض Matrix الوصفية. وtype هو مميّز ثابت للعملاء المتوافقين مع OpenClaw. يجب على العملاء تجاهل قيم type غير المعروفة، والإصدارات غير المعروفة التي لا يمكنهم تفسيرها بأمان، وأنواع الكتل غير المعروفة.
سلوك الاحتياط
يعرض OpenClaw دائمًا نصًا عاديًا مقروءًا كخيار احتياطي داخلbody. وتكون البيانات الوصفية المنظمة إضافةً فقط، ويجب ألا تكون مطلوبة للتشغيل البيني الأساسي مع Matrix.
يجب أن يستمر العملاء غير المدعومين في عرض النص الاحتياطي. وقد يفضّل العملاء المتوافقون مع OpenClaw استخدام البيانات الوصفية المنظمة للعرض مع الاحتفاظ بالنص الاحتياطي للنسخ، والبحث، والإشعارات، وإمكانية الوصول.
الكتل المدعومة
يعلن محوّل Matrix الصادر دعمه لما يلي:buttonsselectcontextdivider
التفاعلات
لا تضيف هذه البيانات الوصفية دلالات استدعاء راجع في Matrix. قيم الأزرار وخيارات التحديد هي حمولات تفاعل احتياطية، وعادةً ما تكون أوامر شرطة مائلة أو أوامر نصية. يمكن لعميل Matrix الذي يريد دعم التفاعل إرسال القيمة المحددة مرة أخرى إلى الغرفة كرسالة عادية. على سبيل المثال، يمكن التعامل مع زر قيمته/model deepseek/deepseek-chat عبر إرسال تلك القيمة كرسالة نصية مشفرة في Matrix داخل الغرفة نفسها.
العلاقة ببيانات الموافقة الوصفية
com.openclaw.presentation مخصص لعرض الرسائل الغنية العامة.
تستخدم مطالبات الموافقة البيانات الوصفية المخصصة com.openclaw.approval لأن الموافقات تحمل حالة حساسة للسلامة، وقرارات، وتفاصيل تنفيذ/Plugin. إذا كان مفتاحا البيانات الوصفية كلاهما موجودين في الحدث نفسه، فيجب على العملاء تفضيل عارض الموافقة المخصص.
رسائل الوسائط
عندما يحتوي الرد على عناوين URL متعددة للوسائط، يرسل OpenClaw حدث Matrix واحدًا لكل عنوان URL للوسائط. تُرفق بيانات العرض الوصفية بحدث الوسائط الأول فقط حتى يكون لدى العملاء حمولة منظمة ثابتة واحدة ويتم تجنب العارضات المكررة. أبقِ بيانات العرض الوصفية موجزة. يجب أن يبقى النص الكبير المرئي للمستخدم فيbody وأن يستخدم مسار تجزئة النص العادي في Matrix.