---
read_when:
    - تغيير طريقة عرض مخرجات المساعد في واجهة التحكم
    - تصحيح أخطاء توجيهات `[embed ...]` و`MEDIA:` والرد أو العرض الصوتي
summary: بروتوكول الرموز القصيرة للمخرجات الغنية للتضمينات والوسائط وتلميحات الصوت والردود
title: بروتوكول الإخراج الغني
x-i18n:
    generated_at: "2026-05-02T22:24:11Z"
    model: gpt-5.5
    provider: openai
    source_hash: 8e0c365029c26d198090e1f181703e3979394afb0dfa1742f9c088885650de8b
    source_path: reference/rich-output-protocol.md
    workflow: 16
---

يمكن أن يحمل خرج المساعد مجموعة صغيرة من توجيهات التسليم/العرض:

- `MEDIA:` لتسليم المرفقات
- `[[audio_as_voice]]` لتلميحات عرض الصوت
- `[[reply_to_current]]` / `[[reply_to:<id>]]` لبيانات تعريف الرد
- `[embed ...]` للعرض الغني في واجهة التحكم

يجب أن تكون مرفقات `MEDIA:` البعيدة عناوين URL عامة بصيغة `https:`. يتم تجاهل `http:` العادي،
وloopback، وlink-local، وأسماء المضيفين الخاصة والداخلية كتوجيهات مرفقات؛ ولا تزال جالبات الوسائط من جهة الخادم تفرض حواجز الشبكة الخاصة بها.

يمكن لمرفقات `MEDIA:` المحلية استخدام مسارات مطلقة، أو مسارات نسبية إلى مساحة العمل، أو
مسارات نسبية إلى المنزل بصيغة `~/`. وهي لا تزال تمر عبر سياسة قراءة الملفات الخاصة بالوكيل وفحوصات نوع الوسائط قبل التسليم.

تبقى صيغة صور Markdown العادية نصا بشكل افتراضي. القنوات التي تعيّن ردود صور Markdown عمدا إلى مرفقات وسائط تشترك في ذلك عبر
المحول الصادر الخاص بها؛ يفعل Telegram ذلك بحيث يمكن أن تتحول `![alt](url)` إلى رد وسائط.

هذه التوجيهات منفصلة. تبقى `MEDIA:` ووسوم الرد/الصوت بيانات تعريف للتسليم؛ ويمثل `[embed ...]` مسار العرض الغني الخاص بالويب فقط.
تستخدم وسائط نتائج الأدوات الموثوقة محلل `MEDIA:` / `[[audio_as_voice]]` نفسه قبل التسليم، بحيث لا تزال مخرجات الأدوات النصية قادرة على وسم مرفق صوتي كملاحظة صوتية.

عند تمكين بث الكتل، تبقى `MEDIA:` بيانات تعريف لتسليم واحد لكل
دورة. إذا أُرسل عنوان URL للوسائط نفسه في كتلة مبثوثة وتكرر في حمولة المساعد النهائية،
يسلم OpenClaw المرفق مرة واحدة ويزيل التكرار من الحمولة النهائية.

## `[embed ...]`

`[embed ...]` هي صيغة العرض الغني الوحيدة الموجهة إلى الوكيل لواجهة التحكم.

مثال ذاتي الإغلاق:

```text
[embed ref="cv_123" title="Status" /]
```

القواعد:

- لم تعد `[view ...]` صالحة للمخرجات الجديدة.
- تعرض الشفرات القصيرة للتضمين في سطح رسالة المساعد فقط.
- لا تعرض إلا التضمينات المدعومة بعناوين URL. استخدم `ref="..."` أو `url="..."`.
- لا تعرض شفرات التضمين القصيرة بصيغة HTML المضمنة ذات شكل الكتلة.
- تزيل واجهة الويب الشفرة القصيرة من النص المرئي وتعرض التضمين داخل السياق.
- ليست `MEDIA:` اسما بديلا للتضمين ولا ينبغي استخدامها لعرض التضمينات الغنية.

## شكل العرض المخزن

كتلة محتوى المساعد المعيارية/المخزنة هي عنصر `canvas` منظم:

```json
{
  "type": "canvas",
  "preview": {
    "kind": "canvas",
    "surface": "assistant_message",
    "render": "url",
    "viewId": "cv_123",
    "url": "/__openclaw__/canvas/documents/cv_123/index.html",
    "title": "Status",
    "preferredHeight": 320
  }
}
```

تستخدم الكتل الغنية المخزنة/المعروضة شكل `canvas` هذا مباشرة. لا يتم التعرف على `present_view`.

## ذات صلة

- [محولات RPC](/ar/reference/rpc)
- [Typebox](/ar/concepts/typebox)