> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# بيانات تعريف عرض Matrix

يمكن لـ OpenClaw إرفاق بيانات وصفية موحّدة من نوع `MessagePresentation` بأحداث Matrix الصادرة من نوع `m.room.message` ضمن `com.openclaw.presentation`.

يستمر عملاء Matrix القياسيون في عرض النص العادي في `body`. ويمكن للعملاء المتوافقين مع OpenClaw قراءة البيانات الوصفية المنظمة وعرض واجهة مستخدم أصلية مثل الأزرار، وقوائم الاختيار، وصفوف السياق، والفواصل.

## محتوى الحدث

تُخزَّن البيانات الوصفية في محتوى حدث Matrix:

```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "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.