MCP

openclaw mcp دو وظیفه دارد:

• اجرای OpenClaw به‌عنوان سرور MCP با openclaw mcp serve
• مدیریت تعریف‌های سرور MCP خروجیِ تحت مدیریت OpenClaw با list، show، status، doctor، probe، add، set، configure، tools، login، logout، reload و unset

serve حالت عملکرد OpenClaw به‌عنوان سرور MCP است. زیرفرمان‌های دیگر، حالت عملکرد OpenClaw به‌عنوان رجیستری سمت کلاینت MCP برای سرورهایی هستند که زمان‌اجراهای خود OpenClaw ممکن است بعداً از آن‌ها استفاده کنند.

وقتی OpenClaw باید خودش یک نشست محیط کدنویسی را میزبانی کند و آن زمان‌اجرا را از طریق ACP مسیریابی کند، از openclaw acp استفاده کنید.

انتخاب مسیر مناسب MCP

OpenClaw به‌عنوان سرور MCP

این مسیر openclaw mcp serve است.

زمان استفاده از serve

از openclaw mcp serve زمانی استفاده کنید که:

• Codex، Claude Code یا کلاینت MCP دیگری باید مستقیماً با گفتگوهای کانال مبتنی بر OpenClaw ارتباط برقرار کند
• از قبل یک Gateway محلی یا راه‌دور OpenClaw با نشست‌های مسیریابی‌شده دارید
• به‌جای اجرای پل‌های جداگانه برای هر کانال، یک سرور MCP می‌خواهید که در همه زیرساخت‌های کانال OpenClaw کار کند

وقتی OpenClaw باید خودش زمان‌اجرای کدنویسی را میزبانی کند و نشست عامل را درون OpenClaw نگه دارد، به‌جای آن از openclaw acp استفاده کنید.

نحوه کار

openclaw mcp serve یک سرور MCP مبتنی بر stdio راه‌اندازی می‌کند. کلاینت MCP مالک آن فرایند است. تا زمانی که کلاینت نشست stdio را باز نگه دارد، پل از طریق WebSocket به یک Gateway محلی یا راه‌دور OpenClaw متصل می‌شود و گفتگوهای کانال مسیریابی‌شده را از طریق MCP ارائه می‌کند.

انتخاب حالت کلاینت

مواردی که serve ارائه می‌کند

پل با استفاده از فراداده مسیر نشست موجود در Gateway، گفتگوهای مبتنی بر کانال را ارائه می‌کند. یک گفتگو زمانی ظاهر می‌شود که OpenClaw از قبل وضعیت نشستی با مسیری شناخته‌شده مانند موارد زیر داشته باشد:

• channel
• فراداده گیرنده یا مقصد
• accountId اختیاری
• threadId اختیاری

این قابلیت یک محل واحد در اختیار کلاینت‌های MCP قرار می‌دهد تا:

• گفتگوهای مسیریابی‌شده اخیر را فهرست کنند
• تاریخچه اخیر رونوشت را بخوانند
• منتظر رویدادهای ورودی جدید بمانند
• پاسخ را از طریق همان مسیر بازگردانند
• درخواست‌های تأییدی را که هنگام اتصال پل می‌رسند مشاهده کنند

روش استفاده

openclaw mcp serve

openclaw mcp serve --url wss://gateway-host:18789 --token-file ~/.openclaw/gateway.token

openclaw mcp serve --url wss://gateway-host:18789 --password-file ~/.openclaw/gateway.password

openclaw mcp serve --verboseopenclaw mcp serve --claude-channel-mode off

ابزارهای پل

مدل رویداد

پل تا زمانی که متصل است یک صف رویداد در حافظه نگه می‌دارد.

انواع فعلی رویداد:

• message
• exec_approval_requested
• exec_approval_resolved
• plugin_approval_requested
• plugin_approval_resolved
• claude_permission_request

اعلان‌های کانال Claude

پل همچنین می‌تواند اعلان‌های کانال ویژه Claude را ارائه کند. این قابلیت معادل آداپتور کانال Claude Code در OpenClaw است: ابزارهای استاندارد MCP همچنان در دسترس می‌مانند، اما پیام‌های ورودی زنده نیز می‌توانند به‌شکل اعلان‌های MCP ویژه Claude وارد شوند.

وقتی حالت کانال Claude فعال باشد، سرور قابلیت‌های آزمایشی Claude را اعلام می‌کند و می‌تواند موارد زیر را منتشر کند:

• notifications/claude/channel
• notifications/claude/channel/permission

رفتار فعلی پل:

• پیام‌های رونوشت ورودی user به‌صورت notifications/claude/channel ارسال می‌شوند
• درخواست‌های مجوز Claude که از طریق MCP دریافت می‌شوند در حافظه پیگیری می‌شوند
• اگر مالک فرمان در گفتگوی پیوندخورده بعداً yes <id> یا no <id> را ارسال کند (<id> شناسه 5 حرفی درخواست، بدون l است)، پل آن را به notifications/claude/channel/permission تبدیل می‌کند
• این اعلان‌ها فقط برای نشست زنده هستند؛ اگر اتصال کلاینت MCP قطع شود، هیچ مقصد ارسالی وجود نخواهد داشت

این رفتار عمداً مختص کلاینت است. کلاینت‌های عمومی MCP باید به ابزارهای استاندارد نظرسنجی متکی باشند.

پیکربندی کلاینت MCP

نمونه پیکربندی کلاینت stdio:

{  "mcpServers": {    "openclaw": {      "command": "openclaw",      "args": [        "mcp",        "serve",        "--url",        "wss://gateway-host:18789",        "--token-file",        "/path/to/gateway.token"      ]    }  }}

برای بیشتر کلاینت‌های عمومی MCP، با سطح ابزار استاندارد شروع کنید و حالت Claude را نادیده بگیرید. حالت Claude را فقط برای کلاینت‌هایی فعال کنید که واقعاً متدهای اعلان مختص Claude را درک می‌کنند.

گزینه‌ها

openclaw mcp serve از موارد زیر پشتیبانی می‌کند:

مرز امنیت و اعتماد

پل مسیریابی ابداع نمی‌کند. فقط مکالماتی را در دسترس قرار می‌دهد که Gateway از قبل می‌داند چگونه مسیریابی کند.

این یعنی:

• فهرست‌های مجاز فرستنده، جفت‌سازی و اعتماد در سطح کانال همچنان به پیکربندی کانال زیربنایی OpenClaw تعلق دارند
• messages_send فقط می‌تواند از طریق یک مسیر ذخیره‌شده موجود پاسخ دهد
• وضعیت تأیید فقط به‌صورت زنده/درون‌حافظه‌ای برای نشست فعلی پل نگه‌داری می‌شود
• احراز هویت پل باید از همان کنترل‌های توکن یا گذرواژه Gateway استفاده کند که برای هر کلاینت راه‌دور دیگر Gateway قابل اعتماد می‌دانید

اگر مکالمه‌ای در conversations_list وجود ندارد، علت معمول پیکربندی MCP نیست. علت، نبودن یا ناقص‌بودن فراداده مسیر در نشست زیربنایی Gateway است.

آزمایش

OpenClaw یک آزمون دود قطعی Docker برای این پل ارائه می‌کند:

pnpm test:docker:mcp-channels

این آزمون دود یک کانتینر واحد را اجرا می‌کند: وضعیت مکالمه را مقداردهی اولیه می‌کند، Gateway را راه‌اندازی می‌کند، سپس openclaw mcp serve را به‌عنوان فرایند فرزند stdio ایجاد می‌کند و آن را مانند یک کلاینت MCP هدایت می‌کند. این آزمون، کشف مکالمه، خواندن رونوشت، خواندن فراداده پیوست‌ها، رفتار صف رویداد زنده و اعلان‌های کانال و مجوز به سبک Claude را از طریق پل واقعی stdio MCP بررسی می‌کند. مسیریابی ارسال خروجی (messages_send با استفاده مجدد از مسیر ذخیره‌شده مکالمه) به‌طور جداگانه با آزمون‌های واحد در src/mcp/channel-server.test.ts پوشش داده می‌شود.

این سریع‌ترین راه برای اثبات کارکرد پل است، بدون آنکه یک حساب واقعی Telegram، Discord یا iMessage را به اجرای آزمایش متصل کنید.

برای زمینه گسترده‌تر آزمایش، به آزمایش مراجعه کنید.

عیب‌یابی

OpenClaw به‌عنوان رجیستری کلاینت MCP

این مسیر openclaw mcp list، show، status، doctor، probe، add، set، configure، tools، login، logout، reload و unset است.

این فرمان‌ها OpenClaw را از طریق MCP در دسترس قرار نمی‌دهند. آن‌ها تعریف‌های سرور MCP مدیریت‌شده توسط OpenClaw را در mcp.servers در پیکربندی OpenClaw مدیریت می‌کنند. آن‌ها سرورهای mcporter را از config/mcporter.json نمی‌خوانند.

این تعریف‌های ذخیره‌شده برای محیط‌های اجرایی هستند که OpenClaw بعداً راه‌اندازی یا پیکربندی می‌کند، مانند OpenClaw توکار و دیگر سازگارکننده‌های محیط اجرایی. OpenClaw تعریف‌ها را به‌صورت متمرکز ذخیره می‌کند تا آن محیط‌های اجرایی مجبور نباشند فهرست‌های تکراری سرور MCP خود را نگه‌داری کنند.

سازگارکننده‌های محیط اجرایی ممکن است این رجیستری مشترک را به شکلی نرمال‌سازی کنند که کلاینت پایین‌دستی آن‌ها انتظار دارد. برای نمونه، OpenClaw توکار مقادیر transport مربوط به OpenClaw را مستقیماً مصرف می‌کند، درحالی‌که Claude Code و Gemini مقادیر بومی CLI در type، مانند http، sse یا stdio را دریافت می‌کنند.

Codex app-server همچنین یک بلوک اختیاری codex را در هر سرور رعایت می‌کند. این فراداده نگاشت OpenClaw فقط برای رشته‌های Codex app-server است؛ این فراداده نشست‌های ACP، پیکربندی عمومی چارچوب Codex یا دیگر سازگارکننده‌های محیط اجرایی را تغییر نمی‌دهد. از codex.agents غیرخالی استفاده کنید تا یک سرور فقط به شناسه‌های مشخص عامل OpenClaw نگاشت شود. فهرست‌های خالی، سفید یا نامعتبر عامل به‌وسیله اعتبارسنجی پیکربندی رد می‌شوند و به‌جای سراسری‌شدن، از مسیر نگاشت محیط اجرایی حذف می‌شوند. از codex.defaultToolsApprovalMode ‏(auto، prompt یا approve) استفاده کنید تا default_tools_approval_mode بومی Codex برای یک سرور قابل اعتماد تولید شود. OpenClaw پیش از تحویل پیکربندی بومی mcp_servers به Codex، فراداده codex را حذف می‌کند.

تعریف‌های ذخیره‌شده سرور MCP

فرمان‌ها:

• openclaw mcp list
• openclaw mcp show [name]
• openclaw mcp status [--verbose]
• openclaw mcp doctor [name] [--probe]
• openclaw mcp probe [name]
• openclaw mcp add <name> [flags]
• openclaw mcp set <name> <json>
• openclaw mcp configure <name> [flags]
• openclaw mcp tools <name> [--include csv] [--exclude csv] [--clear]
• openclaw mcp login <name> [--code code]
• openclaw mcp logout <name>
• openclaw mcp reload
• openclaw mcp unset <name>

نکات:

• list نام سرورها را مرتب می‌کند.
• show بدون نام، شیء کامل سرور MCP پیکربندی‌شده را چاپ می‌کند.
• status انتقال‌های پیکربندی‌شده را بدون اتصال دسته‌بندی می‌کند. --verbose جزئیات رفع‌شده راه‌اندازی، مهلت زمانی، OAuth، فیلتر و فراخوانی موازی را شامل می‌شود.
• doctor بررسی‌های ایستا را بدون اتصال انجام می‌دهد. وقتی فرمان باید اتصال سرورهای فعال را نیز تأیید کند، --probe را اضافه کنید.
• probe متصل می‌شود و تعداد ابزارها، پشتیبانی از منابع/اعلان‌ها، پشتیبانی از تغییرات فهرست و اطلاعات تشخیصی را گزارش می‌دهد.
• add پرچم‌های stdio مانند --command، --arg، --env و --cwd، یا پرچم‌های HTTP مانند --url، --transport، --header، --auth oauth و پرچم‌های TLS، مهلت زمانی و انتخاب ابزار را می‌پذیرد.
• set انتظار یک مقدار شیء JSON در خط فرمان را دارد.
• configure فعال‌بودن، فیلترهای ابزار، مهلت‌های زمانی، OAuth، TLS و راهنمای فراخوانی موازی ابزارها را بدون جایگزین‌کردن کل تعریف سرور به‌روزرسانی می‌کند. برای تأیید سرور به‌روزشده پیش از ذخیره‌سازی، --probe را اضافه کنید.
• tools فیلترهای ابزار هر سرور را به‌روزرسانی می‌کند. ورودی‌های گنجاندن/حذف، نام ابزارهای MCP و الگوهای ساده * هستند.
• login جریان OAuth را برای سرورهای HTTP پیکربندی‌شده با auth: "oauth" اجرا می‌کند. اجرای نخست یک نشانی مجوز چاپ می‌کند؛ پس از تأیید، دوباره با --code اجرا کنید.
• logout اعتبارنامه‌های OAuth ذخیره‌شده سرور نام‌برده را بدون حذف تعریف ذخیره‌شده سرور پاک می‌کند.
• reload محیط‌های اجرایی MCP درون‌فرایندی ذخیره‌شده در حافظه نهان را فقط برای فرایند CLI فعلی آزاد می‌کند. فرایندهای Gateway یا عامل در فرایندی دیگر همچنان به مسیر بازخوانی یا راه‌اندازی مجدد خود نیاز دارند.
• برای سرورهای Streamable HTTP MCP از transport: "streamable-http" استفاده کنید. openclaw mcp set همچنین برای سازگاری، type: "http" بومی CLI را به همان شکل پیکربندی معیار نرمال‌سازی می‌کند.
• unset در صورت نبودن سرور نام‌برده با شکست مواجه می‌شود.

نمونه‌ها:

openclaw mcp listopenclaw mcp show context7 --jsonopenclaw mcp status --verboseopenclaw mcp doctor --probeopenclaw mcp probe context7 --jsonopenclaw mcp add memory --command npx --arg -y --arg @modelcontextprotocol/server-memoryopenclaw mcp set context7 '{"command":"uvx","args":["context7-mcp"]}'openclaw mcp tools context7 --include 'resolve-library-id,get-library-docs'openclaw mcp set docs '{"url":"https://mcp.example.com","transport":"streamable-http"}'openclaw mcp configure docs --timeout 20 --connect-timeout 5 --include 'search,read_*'openclaw mcp configure docs --auth oauth --oauth-scope 'docs.read'openclaw mcp login docsopenclaw mcp logout docsopenclaw mcp unset context7

دستورالعمل‌های رایج سرور

این نمونه‌ها فقط تعریف‌های سرور را ذخیره می‌کنند. پس از آن openclaw mcp doctor --probe را اجرا کنید تا ثابت شود سرور راه‌اندازی می‌شود و ابزارها را ارائه می‌دهد.

openclaw mcp add files \  --command npx \  --arg -y \  --arg @modelcontextprotocol/server-filesystem \  --arg "$HOME/Documents" \  --include 'read_file,list_directory,search_files'openclaw mcp doctor files --probe

openclaw mcp add memory \  --command npx \  --arg -y \  --arg @modelcontextprotocol/server-memoryopenclaw mcp probe memory --json

openclaw mcp add local-tools \  --command node \  --arg ./dist/mcp-server.js \  --cwd /srv/openclaw-tools \  --env API_BASE=https://internal.exampleopenclaw mcp status --verbose

openclaw mcp add docs \  --url https://mcp.example.com/mcp \  --transport streamable-http \  --auth oauth \  --oauth-scope docs.read \  --timeout 20 \  --connect-timeout 5 \  --include 'search,read_*'openclaw mcp doctor docs --probe

openclaw mcp set cua-driver '{"command":"cua-driver","args":["mcp"]}'openclaw mcp tools cua-driver --include 'list_apps,observe,click,type'openclaw mcp doctor cua-driver --probe

ساختارهای خروجی JSON

برای اسکریپت‌ها و داشبوردها از --json استفاده کنید. مجموعهٔ فیلدها ممکن است با گذشت زمان گسترش یابد، بنابراین مصرف‌کنندگان باید کلیدهای ناشناخته را نادیده بگیرند.

{  "path": "/home/user/.openclaw/openclaw.json",  "servers": [    {      "name": "docs",      "configured": true,      "enabled": true,      "ok": true,      "transport": "streamable-http",      "launch": "streamable-http https://mcp.example.com/mcp",      "auth": "oauth",      "authStatus": {        "hasTokens": true,        "hasClientInformation": true,        "hasCodeVerifier": false,        "hasDiscoveryState": true,        "hasLastAuthorizationUrl": false      },      "requestTimeoutMs": 20000,      "connectionTimeoutMs": 5000,      "toolFilter": {        "include": ["search", "read_*"],        "exclude": []      },      "supportsParallelToolCalls": true    }  ]}

{  "ok": true,  "path": "/home/user/.openclaw/openclaw.json",  "servers": [    {      "name": "docs",      "ok": true,      "issues": [        {          "level": "warning",          "message": "اعتبارنامه‌های OAuth مجاز نشده‌اند؛ openclaw mcp login docs را اجرا کنید"        }      ]    }  ]}

{  "generatedAt": "2026-05-31T09:00:00.000Z",  "servers": {    "docs": {      "launch": "streamable-http https://mcp.example.com/mcp",      "tools": 2,      "resources": true,      "listChanged": {        "tools": true,        "resources": false,        "prompts": false      }    }  },  "tools": ["docs__read_page", "docs__search"],  "diagnostics": []}

نمونهٔ ساختار پیکربندی:

{  "mcp": {    "servers": {      "context7": {        "command": "uvx",        "args": ["context7-mcp"]      },      "docs": {        "url": "https://mcp.example.com",        "transport": "streamable-http",        "timeout": 20,        "connectTimeout": 5,        "supportsParallelToolCalls": true,        "auth": "oauth",        "oauth": {          "scope": "docs.read"        },        "sslVerify": true,        "clientCert": "/path/to/client.crt",        "clientKey": "/path/to/client.key",        "toolFilter": {          "include": ["search_*"],          "exclude": ["admin_*"]        }      }    }  }}

انتقال Stdio

یک فرایند فرزند محلی را راه‌اندازی می‌کند و از طریق stdin/stdout با آن ارتباط برقرار می‌کند.

انتقال SSE / HTTP

از طریق رویدادهای ارسال‌شده از سرور HTTP به یک سرور MCP راه‌دور متصل می‌شود.

نمونه:

{  "mcp": {    "servers": {      "remote-tools": {        "url": "https://mcp.example.com",        "auth": "oauth",        "timeout": 20,        "headers": {          "Authorization": "Bearer <token>"        }      }    }  }}

مقادیر حساس در url (اطلاعات کاربر) و headers در گزارش‌ها و خروجی وضعیت پوشانده می‌شوند. وقتی ورودی‌های حساس‌به‌نظررسِ headers یا env حاوی مقادیر صریح باشند، openclaw mcp doctor هشدار می‌دهد تا اپراتورها بتوانند آن مقادیر را از پیکربندی ثبت‌شده در مخزن خارج کنند.

گردش‌کار OAuth

OAuth برای سرورهای MCP مبتنی بر HTTP است که جریان OAuth مربوط به MCP را اعلام می‌کنند. وقتی auth: "oauth" فعال باشد، سرآیندهای ایستای Authorization برای آن سرور نادیده گرفته می‌شوند. اعتبارنامه‌های ذخیره‌شده توسط openclaw mcp login با MCP تعبیه‌شده، اجراکننده‌های CLI و app-server محلی Codex کار می‌کنند.

تا زمانی که اعتبارنامه‌ها در دسترس نباشند، OpenClaw به‌جای شکست نوبت عامل، فقط همان سرور MCP را از زمان اجرای عامل حذف می‌کند. سپس اپراتور یا عاملی با دسترسی پوسته می‌تواند openclaw mcp login <name> را اجرا کند و در نوبتی بعدی از سرور استفاده کند.

وقتی یک سرویس MCP راه‌دور از قبل توسط نمایهٔ احراز هویت جداگانهٔ OpenClaw با قابلیت نوسازی پشتیبانی می‌شود، می‌توانید در صورت تمایل oauth.authProfileId را تنظیم کنید. OpenClaw پیش از نگاشت به زمان اجرا، هر یک از منابع اعتبارنامه را نوسازی می‌کند و فقط توکن دسترسی فعلی را به کلاینت MCP پایین‌دستی می‌دهد.

openclaw mcp set docs '{"url":"https://mcp.example.com/mcp","transport":"streamable-http","auth":"oauth","oauth":{"scope":"docs.read"}}'

openclaw mcp set docs '{"url":"https://mcp.example.com/mcp","transport":"streamable-http","auth":"oauth","oauth":{"authProfileId":"docs:mcp"}}'

openclaw mcp login docs

openclaw mcp login docs --code abc123

openclaw mcp status --verboseopenclaw mcp doctor docs --probe

openclaw mcp logout docs

اگر ارائه‌دهنده توکن‌ها را تعویض کند یا وضعیت مجوزدهی گیر کند، openclaw mcp logout <name> را اجرا کنید، سپس login را تکرار کنید. logout می‌تواند اطلاعات احراز هویت یک سرور HTTP ذخیره‌شده را حتی پس از حذف auth: "oauth" از پیکربندی پاک کند، به‌شرط آنکه نام و URL سرور همچنان ورودی مخزن اطلاعات احراز هویت را مشخص کنند.

انتقال HTTP جریانی

streamable-http در کنار sse و stdio یک گزینهٔ انتقالی دیگر است. این گزینه برای ارتباط دوسویه با سرورهای MCP راه دور از جریان‌سازی HTTP استفاده می‌کند.

پیکربندی OpenClaw از transport: "streamable-http" به‌عنوان املای معیار استفاده می‌کند. مقادیر بومی CLI مربوط به MCP، یعنی type: "http"، هنگام ذخیره‌شدن از طریق openclaw mcp set پذیرفته می‌شوند و در پیکربندی موجود توسط openclaw doctor --fix اصلاح می‌شوند، اما transport مقداری است که OpenClaw تعبیه‌شده مستقیماً مصرف می‌کند.

مثال:

{  "mcp": {    "servers": {      "streaming-tools": {        "url": "https://mcp.example.com/stream",        "transport": "streamable-http",        "connectTimeout": 10,        "timeout": 30,        "headers": {          "Authorization": "Bearer <token>"        }      }    }  }}

رابط کاربری کنترل

رابط کاربری کنترل مبتنی بر مرورگر، یک صفحهٔ اختصاصی تنظیمات MCP در /settings/mcp دارد؛ مسیر قبلی /mcp همچنان به‌عنوان نام مستعار باقی می‌ماند. این صفحه تعداد سرورهای پیکربندی‌شده، خلاصه‌های فعال‌بودن/OAuth/فیلتر، ردیف انتقال هر سرور، کنترل‌های فعال/غیرفعال‌سازی، فرمان‌های رایج CLI و یک ویرایشگر محدود به بخش پیکربندی mcp را نمایش می‌دهد.

از این صفحه برای ویرایش‌های اپراتور و بررسی سریع موجودی استفاده کنید. هنگامی که به اثبات زندهٔ سرور نیاز دارید، از openclaw mcp doctor --probe یا openclaw mcp probe استفاده کنید.

گردش‌کار اپراتور:

1. رابط کاربری کنترل را باز کنید و MCP را انتخاب کنید.
2. کارت‌های خلاصه را برای تعداد کل، سرورهای فعال، OAuth و سرورهای فیلترشده بررسی کنید.
3. از ردیف هر سرور برای مشاهدهٔ راهنمای انتقال، احراز هویت، فیلتر، مهلت و فرمان استفاده کنید.
4. هرگاه می‌خواهید تعریفی را نگه دارید اما آن را از کشف زمان اجرا کنار بگذارید، وضعیت فعال‌بودن را تغییر دهید.
5. برای تغییرات ساختاری مانند سرورهای جدید، سرآیندها، TLS، فرادادهٔ OAuth یا فیلترهای ابزار، بخش پیکربندی محدودشدهٔ mcp را ویرایش کنید.
6. برای فقط ذخیره‌کردن پیکربندی، Save را انتخاب کنید؛ یا برای اعمال آن از طریق مسیر پیکربندی Gateway، Save & Publish را انتخاب کنید.
7. هنگامی که به اثبات زندهٔ راه‌اندازی سرور و فهرست‌شدن ابزارهای آن نیاز دارید، openclaw mcp doctor --probe را اجرا کنید.

نکات:

• قطعه‌فرمان‌ها نام سرورها را در گیومه قرار می‌دهند تا نام‌های غیرمعمول نیز در پوسته قابل کپی باشند
• مقادیر نمایش‌داده‌شدهٔ شبیه URL، اگر حاوی اطلاعات احراز هویت تعبیه‌شده باشند، پیش از رندر پنهان‌سازی می‌شوند
• این صفحه به‌تنهایی انتقال‌های MCP را راه‌اندازی نمی‌کند
• زمان‌های اجرای فعال، بسته به اینکه کدام فرایند مالک کلاینت‌های MCP است، ممکن است به openclaw mcp reload، انتشار پیکربندی Gateway یا راه‌اندازی مجدد فرایند نیاز داشته باشند

برنامه‌های MCP

OpenClaw می‌تواند ابزارهایی را رندر کند که افزونهٔ MCP Apps پایدار را پیاده‌سازی می‌کنند. برنامه‌ها به‌صورت انتخابی فعال می‌شوند، زیرا HTML آن‌ها از سرور MCP پیکربندی‌شده می‌آید و می‌تواند ابزارها یا منابع قابل‌مشاهده برای برنامه را از همان سرور درخواست کند.

پل میزبان را فعال کنید:

openclaw config set mcp.apps.enabled true --strict-json

پس از تغییر این تنظیم، Gateway را مجدداً راه‌اندازی کنید. در صورت فعال‌بودن، OpenClaw یک شنوندهٔ HTTP(S) فقط برای محیط ایزوله روی پورت Gateway به‌علاوهٔ یک راه‌اندازی می‌کند (برای Gateway پیش‌فرض، 18790). رابط کاربری کنترل، برنامه‌ها را از آن مبدأ جداگانه بارگیری می‌کند؛ این شنونده هرگز رابط کاربری کنترل، مسیرهای احرازهویت‌شدهٔ Gateway یا داده‌های کاربر را ارائه نمی‌کند.

اتصال‌های مستقیم Gateway باید به هر دو پورت دسترسی داشته باشند. اگر یک پراکسی معکوس یا پایان‌دهندهٔ TLS رابط کاربری کنترل را ارائه می‌کند، یک مبدأ عمومی اختصاصی به برنامه‌ها بدهید و فقط همان مبدأ را به شنوندهٔ محیط ایزوله پراکسی کنید:

{  mcp: {    apps: {      enabled: true,      sandboxOrigin: "https://mcp-apps.example.com",      sandboxPort: 18790,    },  },}

مبدأ محیط ایزوله باید با مبدأ رابط کاربری کنترل متفاوت باشد. هیچ محتوای احرازهویت‌شده یا حساسی را روی آن میزبانی نکنید.

برای مثال، دموی رسمی و پایهٔ React را می‌توان به‌شکل زیر پیکربندی کرد:

{  mcp: {    apps: { enabled: true },    servers: {      "basic-react": {        command: "npx",        args: ["-y", "@modelcontextprotocol/server-basic-react", "--stdio"],      },    },  },}

مرزهای رفتاری و امنیتی:

• OpenClaw فقط هنگامی افزونهٔ io.modelcontextprotocol/ui را اعلام می‌کند که برنامه‌ها فعال باشند.
• فقط منابع ui:// با نوع MIME دقیق text/html;profile=mcp-app رندر می‌شوند.
• منابع رابط کاربری به 2 MiB محدود می‌شوند، پشت یک پراکسی دو-iframe روی یک مبدأ بیرونی اختصاصی قرار می‌گیرند، در یک مبدأ داخلی مبهم برنامه بارگیری می‌شوند و توسط CSP برگرفته از فرادادهٔ منبع محدود می‌شوند.
• ابزارهای مختص برنامه (_meta.ui.visibility: ["app"]) خارج از فهرست ابزارهای مدل باقی می‌مانند. برنامه‌ها فقط می‌توانند ابزارهای قابل‌مشاهده برای برنامه را روی سرور مالک خود فراخوانی کنند که سیاست مؤثر ابزار OpenClaw را نیز برای اجرایی که نما را ایجاد کرده است، پشت سر بگذارند.
• تا زمانی که سندهای داخلی برنامه برای جداسازی میان برنامه‌ها از مبدأهای مبهم استفاده می‌کنند، مجوزهای برنامهٔ وابسته به مبدأ، مانند دوربین، میکروفن و موقعیت جغرافیایی، اعطا نمی‌شوند.
• HTML برنامه، آرگومان‌های کامل ابزار و نتایج خام، در یک اجارهٔ نمای درون‌حافظه‌ای و محدود به ده دقیقه نگهداری می‌شوند و روی دیسک نوشته یا در فرادادهٔ پیش‌نمایش رونوشت کپی نمی‌شوند. رونوشت فقط یک توصیفگر محدود سرور/ابزار/منبع را که به شناسهٔ فراخوانی ابزار اصلی پیوند دارد ذخیره می‌کند. پس از راه‌اندازی مجدد Gateway، رابط کاربری کنترل می‌تواند آن توصیفگر را با رونوشت نشست احرازهویت‌شده تطبیق دهد و منبع ui:// را دوباره واکشی کند؛ نماهای بازسازی‌شده تا زمانی که یک اجرای تازه مجوزهای فعلی ابزار را برقرار کند، فقط خواندنی هستند.
• openclaw security audit هنگام فعال‌بودن پل هشدار می‌دهد. وقتی به آن نیاز ندارید، با openclaw config set mcp.apps.enabled false --strict-json غیرفعالش کنید.

محدودیت‌های کنونی

این صفحه پل را مطابق آنچه امروز عرضه شده است مستند می‌کند.

محدودیت‌های کنونی:

• کشف مکالمه به فرادادهٔ مسیر نشست موجود Gateway وابسته است
• هیچ پروتکل ارسال عمومی فراتر از آداپتور مختص Claude وجود ندارد
• هنوز هیچ ابزار ویرایش پیام یا واکنش‌دادن وجود ندارد
• انتقال HTTP/SSE/streamable-http به یک سرور راه دور متصل می‌شود؛ هنوز بالادست چندگانه‌ای وجود ندارد
• permissions_list_open فقط تأییدهایی را شامل می‌شود که هنگام اتصال پل مشاهده شده‌اند

مرتبط

• مرجع CLI
• Pluginها