الانتقال إلى المحتوى الرئيسي

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.

يمكن لـ OpenClaw إرفاق بيانات وصفية موحّدة من نوع MessagePresentation بأحداث Matrix الصادرة من نوع m.room.message ضمن com.openclaw.presentation. يستمر عملاء Matrix القياسيون في عرض النص العادي في body. ويمكن للعملاء المتوافقين مع OpenClaw قراءة البيانات الوصفية المنظمة وعرض واجهة مستخدم أصلية مثل الأزرار، وقوائم الاختيار، وصفوف السياق، والفواصل.

محتوى الحدث

تُخزَّن البيانات الوصفية في محتوى حدث Matrix:
{
  "msgtype": "m.text",
  "body": "Select model\n\n- DeepSeek: /model deepseek/deepseek-chat",
  "com.openclaw.presentation": {
    "version": 1,
    "type": "message.presentation",
    "title": "Select model",
    "tone": "info",
    "blocks": [
      {
        "type": "select",
        "placeholder": "Choose model",
        "options": [
          {
            "label": "DeepSeek",
            "value": "/model deepseek/deepseek-chat"
          }
        ]
      }
    ]
  }
}
version هو إصدار مخطط بيانات عرض Matrix الوصفية. وtype هو مميّز ثابت للعملاء المتوافقين مع OpenClaw. يجب على العملاء تجاهل قيم type غير المعروفة، والإصدارات غير المعروفة التي لا يمكنهم تفسيرها بأمان، وأنواع الكتل غير المعروفة.

سلوك الاحتياط

يعرض OpenClaw دائمًا نصًا عاديًا مقروءًا كخيار احتياطي داخل body. وتكون البيانات الوصفية المنظمة إضافةً فقط، ويجب ألا تكون مطلوبة للتشغيل البيني الأساسي مع Matrix. يجب أن يستمر العملاء غير المدعومين في عرض النص الاحتياطي. وقد يفضّل العملاء المتوافقون مع OpenClaw استخدام البيانات الوصفية المنظمة للعرض مع الاحتفاظ بالنص الاحتياطي للنسخ، والبحث، والإشعارات، وإمكانية الوصول.

الكتل المدعومة

يعلن محوّل Matrix الصادر دعمه لما يلي:
  • buttons
  • select
  • context
  • divider
يجب على العملاء التعامل مع هذه الكتل كتلميحات عرض بأفضل جهد. ويجب تجاهل الحقول غير المعروفة وأنواع الكتل غير المعروفة بدلًا من التسبب في فشل عرض الرسالة كاملة.

التفاعلات

لا تضيف هذه البيانات الوصفية دلالات استدعاء راجع في Matrix. قيم الأزرار وخيارات التحديد هي حمولات تفاعل احتياطية، وعادةً ما تكون أوامر شرطة مائلة أو أوامر نصية. يمكن لعميل Matrix الذي يريد دعم التفاعل إرسال القيمة المحددة مرة أخرى إلى الغرفة كرسالة عادية. على سبيل المثال، يمكن التعامل مع زر قيمته /model deepseek/deepseek-chat عبر إرسال تلك القيمة كرسالة نصية مشفرة في Matrix داخل الغرفة نفسها.

العلاقة ببيانات الموافقة الوصفية

com.openclaw.presentation مخصص لعرض الرسائل الغنية العامة. تستخدم مطالبات الموافقة البيانات الوصفية المخصصة com.openclaw.approval لأن الموافقات تحمل حالة حساسة للسلامة، وقرارات، وتفاصيل تنفيذ/Plugin. إذا كان مفتاحا البيانات الوصفية كلاهما موجودين في الحدث نفسه، فيجب على العملاء تفضيل عارض الموافقة المخصص.

رسائل الوسائط

عندما يحتوي الرد على عناوين URL متعددة للوسائط، يرسل OpenClaw حدث Matrix واحدًا لكل عنوان URL للوسائط. تُرفق بيانات العرض الوصفية بحدث الوسائط الأول فقط حتى يكون لدى العملاء حمولة منظمة ثابتة واحدة ويتم تجنب العارضات المكررة. أبقِ بيانات العرض الوصفية موجزة. يجب أن يبقى النص الكبير المرئي للمستخدم في body وأن يستخدم مسار تجزئة النص العادي في Matrix.