> ## 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.

# تكاملات Gateway للتطبيقات الخارجية

يجب أن تتحدث التطبيقات الخارجية مع OpenClaw عبر بروتوكول Gateway اليوم. استخدم
Gateway WebSocket وطرق RPC عندما يريد سكربت، أو لوحة معلومات، أو مهمة CI، أو إضافة IDE،
أو عملية أخرى بدء تشغيلات الوكيل، أو بث الأحداث، أو انتظار
النتائج، أو إلغاء العمل، أو فحص موارد Gateway.

<Warning>
  لا توجد حزمة عميل npm عامة بعد. لا تضف أسماء حزم عميل OpenClaw
  كتبعية للتطبيقات إلى أن تعلن ملاحظات الإصدار عن حزمة منشورة
  وتتضمن هذه الصفحة تعليمات التثبيت.
</Warning>

<Note>
  هذه الصفحة مخصصة للكود خارج عملية OpenClaw. يجب أن يستخدم كود Plugin الذي يعمل
  داخل OpenClaw المسارات الفرعية الموثقة `openclaw/plugin-sdk/*` بدلا من ذلك.
</Note>

## ما المتاح اليوم

| السطح                                    | الحالة | استخدمه من أجل                                                                             |
| ---------------------------------------- | ------ | ------------------------------------------------------------------------------------------ |
| [بروتوكول Gateway](/ar/gateway/protocol) | جاهز   | نقل WebSocket، ومصافحة الاتصال، ونطاقات المصادقة، وإصدارات البروتوكول، والأحداث.           |
| [مرجع Gateway RPC](/ar/reference/rpc)    | جاهز   | طرق Gateway الحالية للوكلاء، والجلسات، والمهام، والنماذج، والأدوات، والمخرجات، والموافقات. |
| [`openclaw agent`](/ar/cli/agent)        | جاهز   | تكامل السكربتات لمرة واحدة عندما يكون التشغيل عبر CLI كافيا.                               |
| [`openclaw message`](/ar/cli/message)    | جاهز   | إرسال الرسائل أو إجراءات القنوات من السكربتات.                                             |

تحتوي شجرة المصدر على عمل حزم داخلي لمكتبة عميل مستقبلية، لكن
هذا ليس سطح تثبيت عاما. تعامل معه كتفصيل تنفيذ معاينة
إلى أن تُنشر الحزم وتُمنح إصدارات.

## المسار الموصى به

1. شغّل Gateway أو اكتشفه.
2. اتصل عبر [بروتوكول Gateway](/ar/gateway/protocol).
3. استدع طرق RPC الموثقة من [مرجع Gateway RPC](/ar/reference/rpc).
4. ثبّت إصدار OpenClaw الذي تختبر عليه.
5. راجع مرجع RPC عند ترقية OpenClaw.

لتشغيلات الوكيل، ابدأ بـ RPC الخاص بـ `agent` واقرنه بـ `agent.wait` عندما
تحتاج إلى نتيجة نهائية. لحالة محادثة دائمة، استخدم طرق `sessions.*`.
لتكاملات واجهة المستخدم، اشترك في أحداث Gateway واعرض فقط
عائلات الأحداث التي يفهمها تطبيقك.

## كود التطبيق مقابل كود Plugin

استخدم Gateway RPC عندما يكون الكود خارج OpenClaw:

* سكربتات Node التي تبدأ تشغيلات الوكيل أو تراقبها
* مهام CI التي تستدعي Gateway
* لوحات المعلومات ولوحات الإدارة
* إضافات IDE
* الجسور الخارجية التي لا تحتاج إلى أن تصبح إضافات قنوات
* اختبارات التكامل مع عمليات نقل Gateway وهمية أو حقيقية

استخدم Plugin SDK عندما يعمل الكود داخل OpenClaw:

* إضافات المزوّدين
* إضافات القنوات
* أدوات أو خطافات دورة الحياة
* إضافات حاضنة الوكيل
* مساعدات وقت تشغيل موثوقة

يجب ألا تستورد التطبيقات الخارجية `openclaw/plugin-sdk/*`؛ فهذه المسارات الفرعية مخصصة
للإضافات التي يحمّلها OpenClaw.

## ذات صلة

* [بروتوكول Gateway](/ar/gateway/protocol)
* [مرجع Gateway RPC](/ar/reference/rpc)
* [أمر CLI agent](/ar/cli/agent)
* [أمر CLI message](/ar/cli/message)
* [حلقة الوكيل](/ar/concepts/agent-loop)
* [بيئات تشغيل الوكيل](/ar/concepts/agent-runtimes)
* [الجلسات](/ar/concepts/session)
* [المهام الخلفية](/ar/automation/tasks)
* [وكلاء ACP](/ar/tools/acp-agents)
* [نظرة عامة على Plugin SDK](/ar/plugins/sdk-overview)