---
read_when:
- شما در حال ساخت یک برنامه خارجی، اسکریپت، داشبورد، کار CI یا افزونه IDE هستید که با OpenClaw ارتباط برقرار میکند.
- شما در حال انتخاب بین Gateway RPC و Plugin SDK هستید
- شما در حال یکپارچهسازی با اجراهای عامل Gateway، نشستها، رویدادها، تأییدها، مدلها یا ابزارها هستید
sidebarTitle: External apps
summary: مسیر یکپارچهسازی فعلی برای برنامههای خارجی، اسکریپتها، داشبوردها، کارهای CI، و افزونههای IDE
title: یکپارچهسازیهای Gateway برای برنامههای خارجی
x-i18n:
generated_at: "2026-06-27T17:43:33Z"
model: gpt-5.5
postprocess_version: locale-links-v1
provider: openai
source_hash: 69a1bee50620326e68d40c821d36c0e321fced755a2b3904d77e55624117cbff
source_path: gateway/external-apps.md
workflow: 16
---
برنامههای خارجی امروز باید از طریق پروتکل Gateway با OpenClaw ارتباط برقرار کنند. وقتی یک اسکریپت، داشبورد، کار CI، افزونه IDE یا فرایندی دیگر میخواهد اجرای عاملها را شروع کند، رویدادها را جریاندهی کند، منتظر نتایج بماند، کار را لغو کند یا منابع Gateway را بررسی کند، از WebSocket و روشهای RPC Gateway استفاده کنید.
هنوز هیچ بسته عمومی کلاینت npm وجود ندارد. تا زمانی که یادداشتهای انتشار یک بسته منتشرشده را اعلام نکردهاند
و این صفحه دستورالعملهای نصب را شامل نشده است، نامهای بسته کلاینت OpenClaw را بهعنوان وابستگیهای برنامه اضافه نکنید.
این صفحه برای کدی است که خارج از فرایند OpenClaw قرار دارد. کد Plugin که
داخل OpenClaw اجرا میشود باید بهجای آن از زیرمسیرهای مستندشده `openclaw/plugin-sdk/*` استفاده کند.
## آنچه امروز در دسترس است
| سطح | وضعیت | برای این مورد استفاده کنید |
| -------------------------------------- | ------ | -------------------------------------------------------------------------------------------------- |
| [پروتکل Gateway](/fa/gateway/protocol) | آماده | انتقال WebSocket، دستدهی اتصال، دامنههای احراز هویت، نسخهبندی پروتکل و رویدادها. |
| [مرجع RPC Gateway](/fa/reference/rpc) | آماده | روشهای فعلی Gateway برای عاملها، نشستها، کارها، مدلها، ابزارها، مصنوعات و تأییدها. |
| [`openclaw agent`](/fa/cli/agent) | آماده | یکپارچهسازی اسکریپت یکباره وقتی فراخوانی CLI از پوسته کافی است. |
| [`openclaw message`](/fa/cli/message) | آماده | ارسال پیامها یا کنشهای کانال از اسکریپتها. |
درخت منبع شامل کار بسته داخلی برای یک کتابخانه کلاینت آینده است، اما
این یک سطح نصب عمومی نیست. تا زمانی که بستهها منتشر و نسخهبندی شوند، آن را جزئیات پیادهسازی پیشنمایش در نظر بگیرید.
## مسیر پیشنهادی
1. یک Gateway را اجرا یا کشف کنید.
2. از طریق [پروتکل Gateway](/fa/gateway/protocol) متصل شوید.
3. روشهای RPC مستندشده را از [مرجع RPC Gateway](/fa/reference/rpc) فراخوانی کنید.
4. نسخه OpenClaw را که در برابر آن آزمایش میکنید پین کنید.
5. هنگام ارتقای OpenClaw، مرجع RPC را دوباره بررسی کنید.
برای اجرای عاملها، با RPC `agent` شروع کنید و وقتی
به نتیجه پایانی نیاز دارید، آن را با `agent.wait` همراه کنید. برای وضعیت گفتوگوی پایدار، از روشهای `sessions.*`
استفاده کنید. برای یکپارچهسازیهای رابط کاربری، در رویدادهای Gateway مشترک شوید و فقط خانوادههای رویدادی را که برنامه شما میفهمد رندر کنید.
## کد برنامه در برابر کد Plugin
وقتی کد خارج از OpenClaw قرار دارد، از RPC Gateway استفاده کنید:
- اسکریپتهای Node که اجرای عاملها را شروع یا مشاهده میکنند
- کارهای CI که یک Gateway را فراخوانی میکنند
- داشبوردها و پنلهای مدیریت
- افزونههای IDE
- پلهای خارجی که نیازی ندارند به Pluginهای کانال تبدیل شوند
- آزمونهای یکپارچهسازی با انتقالهای Gateway جعلی یا واقعی
وقتی کد داخل OpenClaw اجرا میشود، از SDK Plugin استفاده کنید:
- Pluginهای ارائهدهنده
- Pluginهای کانال
- ابزار یا هوکهای چرخه عمر
- Pluginهای مهار عامل
- کمککنندههای زمان اجرای مورد اعتماد
برنامههای خارجی نباید `openclaw/plugin-sdk/*` را import کنند؛ این زیرمسیرها برای
Pluginهایی هستند که توسط OpenClaw بارگذاری میشوند.
## مرتبط
- [پروتکل Gateway](/fa/gateway/protocol)
- [مرجع RPC Gateway](/fa/reference/rpc)
- [فرمان عامل CLI](/fa/cli/agent)
- [فرمان پیام CLI](/fa/cli/message)
- [حلقه عامل](/fa/concepts/agent-loop)
- [زمانهای اجرای عامل](/fa/concepts/agent-runtimes)
- [نشستها](/fa/concepts/session)
- [کارهای پسزمینه](/fa/automation/tasks)
- [عاملهای ACP](/fa/tools/acp-agents)
- [نمای کلی SDK Plugin](/fa/plugins/sdk-overview)