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 सत्र route metadata का उपयोग करता है। बातचीत तब दिखाई देती है जब OpenClaw के पास पहले से किसी ज्ञात route के साथ सत्र स्थिति हो, जैसे:

• channel
• प्राप्तकर्ता या गंतव्य metadata
• वैकल्पिक accountId
• वैकल्पिक threadId

इससे MCP क्लाइंट को एक जगह मिलती है जहाँ वे:

• हाल की रूट की गई बातचीत सूचीबद्ध कर सकते हैं
• हाल का ट्रांसक्रिप्ट इतिहास पढ़ सकते हैं
• नए इनबाउंड इवेंट की प्रतीक्षा कर सकते हैं
• उसी route से जवाब वापस भेज सकते हैं
• ब्रिज जुड़े रहने के दौरान आने वाले अनुमोदन अनुरोध देख सकते हैं

उपयोग

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 टूल उजागर करता है:

इवेंट मॉडल

ब्रिज जुड़े रहने के दौरान in-memory इवेंट कतार रखता है।

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

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

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

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

जब Claude चैनल मोड सक्षम होता है, सर्वर Claude experimental capabilities घोषित करता है और ये emit कर सकता है:

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

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

• इनबाउंड user ट्रांसक्रिप्ट संदेश notifications/claude/channel के रूप में forward किए जाते हैं
• MCP पर प्राप्त Claude अनुमति अनुरोध in-memory tracked रहते हैं
• यदि linked बातचीत में command owner बाद में yes abcde या no abcde भेजता है, तो ब्रिज उसे notifications/claude/channel/permission में बदल देता है
• ये सूचनाएँ केवल live-session हैं; यदि MCP क्लाइंट डिस्कनेक्ट हो जाता है, तो कोई push target नहीं रहता

यह जानबूझकर client-specific है। Generic MCP क्लाइंट को मानक polling tools पर निर्भर रहना चाहिए।

MCP क्लाइंट कॉन्फिग

उदाहरण stdio क्लाइंट कॉन्फिग:

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

अधिकांश generic MCP क्लाइंट के लिए, मानक tool surface से शुरू करें और Claude mode को अनदेखा करें। Claude mode केवल उन क्लाइंट के लिए चालू करें जो वास्तव में Claude-विशिष्ट notification methods समझते हैं।

विकल्प

openclaw mcp serve समर्थन करता है:

सुरक्षा और विश्वास सीमा

ब्रिज रूटिंग नहीं गढ़ता. यह केवल वे बातचीत उजागर करता है जिन्हें Gateway पहले से रूट करना जानता है.

इसका अर्थ है:

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

अगर कोई बातचीत conversations_list से गायब है, तो सामान्य कारण MCP कॉन्फ़िगरेशन नहीं होता. यह अंतर्निहित Gateway सत्र में गायब या अधूरा रूट मेटाडेटा होता है.

परीक्षण

OpenClaw इस ब्रिज के लिए एक निर्धारक Docker smoke भेजता है:

pnpm test:docker:mcp-channels

वह smoke:

• एक seeded Gateway कंटेनर शुरू करता है
• दूसरा कंटेनर शुरू करता है जो openclaw mcp serve चलाता है
• बातचीत खोज, transcript reads, attachment metadata reads, live event queue व्यवहार, और outbound send routing सत्यापित करता है
• वास्तविक stdio MCP ब्रिज पर Claude-शैली चैनल और अनुमति सूचनाओं को मान्य करता है

यह किसी वास्तविक Telegram, Discord, या iMessage खाते को टेस्ट रन में जोड़े बिना ब्रिज के काम करने को सिद्ध करने का सबसे तेज़ तरीका है.

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

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

MCP क्लाइंट 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-प्रबंधित 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 पर optional 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 किया जाता है और runtime projection path द्वारा global बनने के बजाय omit किया जाता है. Trusted server के लिए Codex का native default_tools_approval_mode emit करने के लिए codex.defaultToolsApprovalMode (auto, prompt, या approve) इस्तेमाल करें. OpenClaw native mcp_servers config Codex को सौंपने से पहले codex metadata हटा देता है.

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 होने को भी verify करना हो, तो --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.
• set command line पर एक JSON object value की अपेक्षा करता है.
• configure पूरी server definition बदले बिना 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 के साथ फिर चलाएं.
• logout saved server definition हटाए बिना named server के stored OAuth credentials clear करता है.
• 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 करता है.
• अगर named server मौजूद नहीं है तो unset fail होता है.

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 करते हैं. बाद में openclaw mcp doctor --probe चलाकर सिद्ध करें कि server start होता है और tools expose करता है.

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 में redact किए जाते हैं। जब sensitive-looking headers या env entries में शाब्दिक मान होते हैं, तो openclaw mcp doctor चेतावनी देता है, ताकि ऑपरेटर उन मानों को committed config से बाहर ले जा सकें।

OAuth workflow

OAuth उन HTTP MCP सर्वरों के लिए है जो MCP OAuth flow का विज्ञापन करते हैं। जब किसी सर्वर के लिए auth: "oauth" सक्षम हो, तो स्थिर 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 सहेजे गए HTTP सर्वर के लिए credentials साफ़ कर सकता है, भले ही auth: "oauth" कॉन्फ़िग से हटा दिया गया हो, बशर्ते 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 के माध्यम से सहेजे जाने पर स्वीकार किए जाते हैं और मौजूदा config में openclaw doctor --fix द्वारा सुधारे जाते हैं, लेकिन 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, प्रति-सर्वर transport rows, enable/disable controls, सामान्य CLI commands, और mcp config section के लिए scoped editor दिखाता है।

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

Operator workflow:

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

नोट्स:

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

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

यह पेज bridge को आज shipped रूप में document करता है.

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

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

संबंधित

• CLI reference
• Plugins