MCP

openclaw mcp के दो काम हैं:

• openclaw mcp serve के साथ OpenClaw को MCP सर्वर के रूप में चलाना
• list, show, status, doctor, probe, add, set, configure, tools, login, logout, reload, और unset के साथ OpenClaw-प्रबंधित आउटबाउंड MCP सर्वर परिभाषाओं को प्रबंधित करना

दूसरे शब्दों में:

• serve OpenClaw का MCP सर्वर के रूप में काम करना है
• अन्य सबकमांड OpenClaw का MCP सर्वरों के लिए MCP क्लाइंट-साइड रजिस्ट्री के रूप में काम करना है, जिन्हें इसके रनटाइम बाद में उपयोग कर सकते हैं

जब OpenClaw को खुद एक कोडिंग हार्नेस सत्र होस्ट करना हो और उस रनटाइम को ACP के माध्यम से रूट करना हो, तो openclaw acp का उपयोग करें।

सही MCP पथ चुनें

OpenClaw में कई MCP सतहें हैं। वह चुनें जो इस बात से मेल खाती हो कि एजेंट रनटाइम का स्वामी कौन है और टूल्स का स्वामी कौन है।

MCP सर्वर के रूप में OpenClaw

यह openclaw mcp serve पथ है।

serve कब उपयोग करें

openclaw mcp serve का उपयोग करें जब:

• Codex, Claude Code, या किसी अन्य MCP क्लाइंट को OpenClaw-समर्थित चैनल वार्तालापों से सीधे बात करनी चाहिए
• आपके पास पहले से रूटेड सत्रों वाला स्थानीय या दूरस्थ OpenClaw Gateway है
• आप अलग-अलग प्रति-चैनल ब्रिज चलाने के बजाय एक MCP सर्वर चाहते हैं जो OpenClaw के चैनल बैकएंड्स पर काम करे

जब OpenClaw को खुद कोडिंग रनटाइम होस्ट करना हो और एजेंट सत्र को OpenClaw के अंदर रखना हो, तो इसके बजाय openclaw acp का उपयोग करें।

यह कैसे काम करता है

openclaw mcp serve एक stdio MCP सर्वर शुरू करता है। MCP क्लाइंट उस प्रक्रिया का स्वामी होता है। जब तक क्लाइंट stdio सत्र खुला रखता है, ब्रिज WebSocket पर स्थानीय या दूरस्थ OpenClaw Gateway से जुड़ता है और रूटेड चैनल वार्तालापों को 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

ब्रिज टूल्स

वर्तमान ब्रिज ये MCP टूल्स उजागर करता है:

इवेंट मॉडल

ब्रिज कनेक्टेड रहने के दौरान इन-मेमोरी इवेंट कतार रखता है।

वर्तमान इवेंट प्रकार:

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

Claude चैनल सूचनाएं

ब्रिज Claude-विशिष्ट चैनल सूचनाएं भी उजागर कर सकता है। यह Claude Code चैनल एडाप्टर का OpenClaw समकक्ष है: मानक MCP टूल्स उपलब्ध रहते हैं, लेकिन लाइव इनबाउंड संदेश Claude-विशिष्ट MCP सूचनाओं के रूप में भी आ सकते हैं।

जब Claude चैनल मोड सक्षम होता है, तो सर्वर Claude प्रयोगात्मक क्षमताओं का विज्ञापन करता है और ये उत्सर्जित कर सकता है:

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

वर्तमान ब्रिज व्यवहार:

• इनबाउंड user ट्रांसक्रिप्ट संदेश notifications/claude/channel के रूप में आगे भेजे जाते हैं
• MCP पर प्राप्त Claude अनुमति अनुरोध इन-मेमोरी ट्रैक किए जाते हैं
• यदि लिंक किया गया वार्तालाप बाद में yes abcde या no abcde भेजता है, तो ब्रिज उसे 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 पहले से रूट करना जानता है।

इसका अर्थ है:

• प्रेषक allowlists, pairing, और चैनल-स्तरीय भरोसा अभी भी अंतर्निहित OpenClaw चैनल कॉन्फ़िगरेशन के अधीन हैं
• messages_send केवल किसी मौजूदा संग्रहीत रूट के माध्यम से जवाब दे सकता है
• approval स्थिति केवल मौजूदा ब्रिज सत्र के लिए live/in-memory होती है
• ब्रिज auth में वही Gateway टोकन या पासवर्ड नियंत्रण उपयोग होने चाहिए जिन पर आप किसी अन्य remote Gateway क्लाइंट के लिए भरोसा करेंगे

यदि कोई वार्तालाप conversations_list में नहीं है, तो सामान्य कारण MCP कॉन्फ़िगरेशन नहीं होता। यह अंतर्निहित Gateway सत्र में अनुपस्थित या अधूरी रूट metadata होती है।

परीक्षण

OpenClaw इस ब्रिज के लिए एक deterministic Docker smoke शामिल करता है:

pnpm test:docker:mcp-channels

वह smoke:

• एक seeded Gateway container शुरू करता है
• दूसरा container शुरू करता है जो openclaw mcp serve spawn करता है
• वार्तालाप खोज, transcript reads, attachment metadata reads, live event queue behavior, और outbound send routing को सत्यापित करता है
• वास्तविक stdio MCP ब्रिज पर Claude-style चैनल और permission notifications को validate करता है

यह किसी वास्तविक Telegram, Discord, या iMessage account को test run में जोड़े बिना ब्रिज के काम करने का प्रमाण पाने का सबसे तेज़ तरीका है।

व्यापक परीक्षण संदर्भ के लिए, परीक्षण देखें।

समस्या निवारण

MCP client registry के रूप में OpenClaw

यह openclaw mcp list, show, status, doctor, probe, add, set, configure, tools, login, logout, reload, और unset path है।

ये commands OpenClaw को MCP पर expose नहीं करते। ये OpenClaw config में mcp.servers के अंतर्गत OpenClaw-managed MCP server definitions को manage करते हैं। ये config/mcporter.json से mcporter servers नहीं पढ़ते।

वे saved definitions उन runtimes के लिए हैं जिन्हें OpenClaw बाद में launch या configure करता है, जैसे embedded OpenClaw और अन्य runtime adapters। OpenClaw definitions को centrally store करता है ताकि उन runtimes को अपनी duplicate MCP server lists रखने की आवश्यकता न हो।

Runtime adapters इस shared registry को उस shape में normalize कर सकते हैं जिसकी उनके downstream client को अपेक्षा है। उदाहरण के लिए, embedded OpenClaw OpenClaw transport values को सीधे consume करता है, जबकि Claude Code और Gemini को CLI-native type values जैसे http, sse, या stdio मिलते हैं।

Codex app-server प्रत्येक server पर वैकल्पिक codex block का भी सम्मान करता है। यह केवल Codex app-server threads के लिए OpenClaw projection metadata है; यह ACP sessions, generic Codex harness config, या अन्य runtime adapters को नहीं बदलता। किसी server को केवल specific OpenClaw agent ids में project करने के लिए non-empty codex.agents का उपयोग करें। Empty, blank, या invalid agent lists config validation द्वारा reject की जाती हैं और global बनने के बजाय runtime projection path द्वारा omit की जाती हैं। trusted server के लिए Codex का native default_tools_approval_mode emit करने हेतु codex.defaultToolsApprovalMode (auto, prompt, या approve) का उपयोग करें। OpenClaw native mcp_servers config Codex को सौंपने से पहले codex metadata को strip करता है।

Saved MCP server definitions

OpenClaw उन surfaces के लिए config में lightweight MCP server registry भी store करता है जिन्हें OpenClaw-managed MCP definitions चाहिए।

Commands:

• 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>

Notes:

• list server names को sort करता है।
• show बिना name के full configured MCP server object print करता है।
• status connect किए बिना configured transports को classify करता है। --verbose में resolved launch, timeout, OAuth, filter, और parallel-call details शामिल होते हैं।
• doctor connect किए बिना static checks करता है। जब command को enabled servers के connect होने की भी verification करनी हो, तो --probe जोड़ें।
• probe connect करता है और tool counts, resources/prompts support, list-change support, और diagnostics report करता है।
• add stdio flags जैसे --command, --arg, --env, और --cwd, या HTTP flags जैसे --url, --transport, --header, --auth oauth, TLS, timeout, और tool-selection flags accept करता है।
• set command line पर एक JSON object value expect करता है।
• configure पूरी server definition replace किए बिना enablement, tool filters, timeouts, OAuth, TLS, और parallel-tool-call hints update करता है।
• tools per-server tool filters update करता है। Include/exclude entries MCP tool names और simple * globs होते हैं।
• login auth: "oauth" के साथ configured HTTP servers के लिए OAuth flow चलाता है। पहला run authorization URL print करता है; approval के बाद --code के साथ rerun करें।
• logout named server के stored OAuth credentials clear करता है, saved server definition को remove किए बिना।
• reload cached in-process MCP runtimes dispose करता है। दूसरे process में Gateway या agent processes को अभी भी अपना reload या restart path चाहिए।
• Streamable HTTP MCP servers के लिए transport: "streamable-http" का उपयोग करें। openclaw mcp set compatibility के लिए CLI-native type: "http" को भी उसी canonical config shape में normalize करता है।
• unset fail होता है यदि named server मौजूद नहीं है।

Examples:

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

सामान्य server recipes

ये examples केवल server definitions save करते हैं। यह prove करने के लिए कि server start होता है और tools expose करता है, बाद में 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": false,  "path": "/home/user/.openclaw/openclaw.json",  "servers": [    {      "name": "docs",      "ok": false,      "issues": [        {          "level": "error",          "message": "OAuth credentials are not authorized; run openclaw mcp login docs"        }      ]    }  ]}

{  "path": "/home/user/.openclaw/openclaw.json",  "generatedAt": "2026-05-31T09:00:00.000Z",  "servers": {    "docs": {      "launch": "streamable-http https://mcp.example.com/mcp",      "tools": 2,      "resources": true,      "prompts": false,      "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 Server-Sent Events पर रिमोट MCP सर्वर से कनेक्ट करता है।

उदाहरण:

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

url (userinfo) और headers में संवेदनशील मान logs और status output में redacted होते हैं। जब संवेदनशील दिखने वाली headers या env entries में शाब्दिक मान होते हैं, तो openclaw mcp doctor चेतावनी देता है, ताकि operators उन मानों को committed config से बाहर ले जा सकें।

OAuth वर्कफ्लो

OAuth उन HTTP MCP सर्वरों के लिए है जो MCP OAuth flow advertise करते हैं। जब किसी सर्वर के लिए auth: "oauth" सक्षम हो, तो static Authorization headers अनदेखे किए जाते हैं।

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

openclaw mcp login docs

openclaw mcp login docs --code abc123

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

openclaw mcp logout docs

यदि provider tokens rotate करता है या authorization state अटक जाती है, तो openclaw mcp logout <name> चलाएं, फिर login दोहराएं। logout किसी saved HTTP सर्वर के लिए credentials साफ कर सकता है, भले ही auth: "oauth" config से हटा दिया गया हो, जब तक server name और URL अब भी credential store entry की पहचान करते हों।

Streamable HTTP ट्रांसपोर्ट

streamable-http sse और stdio के साथ एक अतिरिक्त transport option है। यह रिमोट MCP सर्वरों के साथ द्विदिश संचार के लिए HTTP streaming का उपयोग करता है।

OpenClaw config canonical spelling के रूप में transport: "streamable-http" का उपयोग करता है। CLI-native MCP type: "http" मान openclaw mcp set के माध्यम से save किए जाने पर स्वीकार किए जाते हैं और मौजूदा config में openclaw doctor --fix द्वारा repaired किए जाते हैं, लेकिन embedded OpenClaw सीधे transport का उपभोग करता है।

उदाहरण:

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

Control UI

ब्राउज़र Control UI में /mcp पर एक समर्पित MCP settings page शामिल है। यह configured server counts, enabled/OAuth/filter summaries, per-server transport rows, enable/disable controls, common CLI commands, और mcp config section के लिए scoped editor दिखाता है।

operator edits और quick inventory के लिए इस पेज का उपयोग करें। जब आपको live server proof चाहिए, तो openclaw mcp doctor --probe या openclaw mcp probe का उपयोग करें।

Operator workflow:

1. Control UI खोलें और MCP चुनें।
2. कुल, सक्षम, OAuth, और फ़िल्टर किए गए सर्वरों के लिए सारांश कार्डों की समीक्षा करें।
3. transport, auth, filter, timeout, और command संकेतों के लिए प्रत्येक सर्वर पंक्ति का उपयोग करें।
4. जब आप किसी परिभाषा को रखना चाहते हैं लेकिन उसे runtime discovery से बाहर करना चाहते हैं, तो enablement टॉगल करें।
5. नए सर्वर, headers, TLS, OAuth metadata, या tool filters जैसे संरचनात्मक बदलावों के लिए scoped mcp config section संपादित करें।
6. केवल config बनाए रखने के लिए Save चुनें, या Gateway config path के माध्यम से लागू करने के लिए Save & Publish चुनें।
7. जब आपको live proof चाहिए कि संपादित सर्वर शुरू होता है और tools सूचीबद्ध करता है, तो openclaw mcp doctor --probe चलाएँ।

नोट्स:

• command snippets सर्वर नामों को quote करते हैं ताकि असामान्य नाम shell में copyable रहें
• प्रदर्शित URL-जैसे मान rendering से पहले redacted किए जाते हैं जब उनमें embedded credentials होते हैं
• पृष्ठ अपने आप MCP transports शुरू नहीं करता
• active runtimes को MCP clients का स्वामी कौन-सी process है, इस पर निर्भर करते हुए openclaw mcp reload, Gateway config publish, या process restart की आवश्यकता हो सकती है

वर्तमान सीमाएँ

यह पृष्ठ bridge को वैसा ही दस्तावेज़ित करता है जैसा वह आज shipped है।

वर्तमान सीमाएँ:

• conversation discovery मौजूदा Gateway session route metadata पर निर्भर करती है
• Claude-specific adapter से आगे कोई generic push protocol नहीं है
• अभी तक कोई message edit या react tools नहीं हैं
• HTTP/SSE/streamable-http transport एक single remote server से जुड़ता है; अभी कोई multiplexed upstream नहीं है
• permissions_list_open में केवल वे approvals शामिल हैं जो bridge के connected रहने के दौरान देखे गए हैं

संबंधित

• CLI संदर्भ
• Plugins