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 باید خودش یک نشست محیط کدنویسی را میزبانی و آن زمان‌اجرا را از طریق ACP مسیریابی کند، از openclaw acp استفاده کنید.

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

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

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

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

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

• کدکس، 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 را ارائه کند. این قابلیت معادل OpenClaw برای آداپتور کانال Claude Code است: ابزارهای استاندارد 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، فیلتر و فراخوانی موازی را شامل می‌شود، از جمله زمانی که توکن‌های ذخیره‌شده OAuth به مجوزدهی بیشتری نیاز دارند. آرگومان‌های stdio حاوی اعتبارنامه در خروجی متنی و JSON پوشانده می‌شوند.
• 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,get_window_state,click,type_text'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,        "requiresAuthorization": false,        "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",        "requestTimeoutMs": 20000,        "connectionTimeoutMs": 5000,        "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 Server-Sent Events به یک سرور MCP راه دور متصل می‌شود.

نمونه:

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

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

گردش‌کار OAuth

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

نشست‌های بومی OAuth مربوط به MCP در پایگاه‌داده SQLite مشترک و فقط در اختیار مالک در <state-dir>/state/openclaw.sqlite (mcp_oauth_stores) قرار دارند. ردیف می‌تواند حاوی توکن‌های دسترسی و نوسازی، اسرار ثبت پویای کلاینت، فراداده اکتشاف و تأییدکننده موقت PKCE باشد. نوسازی، ورود و خروج از همان اجاره SQLite استفاده می‌کنند، بنابراین فرایندهای موازی OpenClaw نمی‌توانند یک توکن نوسازی را مصرف کنند یا نشست خارج‌شده را دوباره زنده کنند.

ارتقا از مخزن منسوخ‌شده <state-dir>/mcp-oauth/*.json فقط توسط openclaw doctor --fix انجام می‌شود. کد زمان اجرا هرگز آن فایل‌ها را نمی‌خواند، در آن‌ها نمی‌نویسد یا به آن‌ها بازنمی‌گردد.

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

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

مثال:

{  "mcp": {    "servers": {      "streaming-tools": {        "url": "https://mcp.example.com/stream",        "transport": "streamable-http",        "connectionTimeoutMs": 10000,        "requestTimeoutMs": 30000,        "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 پایدار را پیاده‌سازی می‌کنند. برنامه‌ها اختیاری هستند، زیرا 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:// را دوباره دریافت کند؛ نماهای بازسازی‌شده تا زمانی که یک اجرای تازه مجوزهای فعلی ابزار را برقرار کند، فقط خواندنی هستند.
• در مکالمات کانال، آخرین نمای موفق برنامه در یک نوبت، یک کنش به سبک بازکردن برنامه به پاسخ نهایی دستیار اضافه می‌کند. پیام‌های مستقیم Telegram از یک دکمه بومی Mini App استفاده می‌کنند؛ Slack و Discord همان کنش قابل‌حمل را به‌شکل پیوند رندر می‌کنند. کانال‌های دیگر متن اصلی پاسخ را نگه می‌دارند و یک پیوند قابل‌فهم HTTPS به آن می‌افزایند.
• پیوندهای راه‌اندازی کانال فقط زمانی در دسترس‌اند که ارائه Tailscale در Gateway یک مبدأ HTTPS منتشرشده آماده کرده باشد. gateway.tailscale.mode: "serve" فقط از tailnet قابل‌دسترسی است؛ "funnel" از اینترنت عمومی قابل‌دسترسی است. یک Funnel مدیریت‌شده خارجی که توسط gateway.tailscale.preserveFunnel حفظ شده نیز قابل‌دسترسی از اینترنت در نظر گرفته می‌شود. Tailscale را ببینید.
• بلیت‌های راه‌اندازی مات هستند، فقط هنگام ساخت پاسخ نهایی کانال صادر می‌شوند و حداکثر پس از دو دقیقه یا هنگام انقضای اجاره نمای زیربنایی، هرکدام زودتر رخ دهد، منقضی می‌شوند. URL حاوی اطلاعات اعتبارسنجی حامل Gateway، کلیدهای نشست، فراداده نما، HTML برنامه، ورودی ابزار یا نتایج ابزار نیست.
• اگر هیچ مبدأ منتشرشده یا ظرفیت بلیتی در دسترس نباشد، نما یا بلیت منقضی شده باشد، یا انتقال نتواند کنترل‌های بومی را رندر کند، متن اصلی دستیار همچنان در دسترس می‌ماند. رابط کاربری کنترل بوم درون‌خطی موجود برنامه را نگه می‌دارد و کنش راه‌اندازی تکراری دریافت نمی‌کند.
• openclaw security audit هنگام فعال‌بودن پل هشدار می‌دهد. وقتی به آن نیاز نیست، با openclaw config set mcp.apps.enabled false --strict-json غیرفعالش کنید.

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

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

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

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

مرتبط

• مرجع CLI
• Pluginها