Plugin बंडल

OpenClaw तीन बाहरी इकोसिस्टम से Plugin इंस्टॉल कर सकता है: Codex, Claude, और Cursor। इन्हें बंडल कहा जाता है — सामग्री और मेटाडेटा पैक जिन्हें OpenClaw Skills, हुक और MCP टूल जैसी नेटिव सुविधाओं में मैप करता है।

बंडल क्यों मौजूद हैं

कई उपयोगी Plugin Codex, Claude या Cursor फ़ॉर्मैट में प्रकाशित होते हैं। लेखकों से उन्हें नेटिव OpenClaw Plugin के रूप में दोबारा लिखवाने के बजाय, OpenClaw इन फ़ॉर्मैट को पहचानता है और उनकी समर्थित सामग्री को नेटिव सुविधा सेट में मैप करता है। इसका मतलब है कि आप Claude कमांड पैक या Codex Skill बंडल इंस्टॉल कर सकते हैं और तुरंत उसका उपयोग कर सकते हैं।

बंडल इंस्टॉल करें

# Local directoryopenclaw plugins install ./my-bundle # Archiveopenclaw plugins install ./my-bundle.tgz # Claude marketplaceopenclaw plugins marketplace list <marketplace-name>openclaw plugins install <plugin-name>@<marketplace-name>

openclaw plugins listopenclaw plugins inspect <id>

openclaw gateway restart

OpenClaw बंडल से क्या मैप करता है

आज OpenClaw में हर बंडल सुविधा नहीं चलती। यहां बताया गया है कि क्या काम करता है और क्या पहचाना गया है लेकिन अभी वायर नहीं किया गया है।

अभी समर्थित

Skill सामग्री

• बंडल Skill रूट सामान्य OpenClaw Skill रूट के रूप में लोड होते हैं
• Claude commands रूट को अतिरिक्त Skill रूट माना जाता है
• Cursor .cursor/commands रूट को अतिरिक्त Skill रूट माना जाता है

इसका मतलब है कि Claude मार्कडाउन कमांड फ़ाइलें सामान्य OpenClaw Skill लोडर के ज़रिए काम करती हैं। Cursor कमांड मार्कडाउन भी उसी पथ से काम करता है।

हुक पैक

• बंडल हुक रूट सिर्फ़ तब काम करते हैं जब वे सामान्य OpenClaw हुक-पैक लेआउट का उपयोग करते हैं। आज यह मुख्य रूप से Codex-संगत मामला है:
  • HOOK.md
  • handler.ts या handler.js

एम्बेडेड OpenClaw के लिए MCP

• सक्षम बंडल MCP सर्वर कॉन्फ़िग दे सकते हैं
• OpenClaw बंडल MCP कॉन्फ़िग को प्रभावी एम्बेडेड OpenClaw सेटिंग्स में mcpServers के रूप में मर्ज करता है
• OpenClaw एम्बेडेड OpenClaw एजेंट टर्न के दौरान समर्थित बंडल MCP टूल stdio सर्वर लॉन्च करके या HTTP सर्वर से कनेक्ट करके उपलब्ध कराता है
• coding और messaging टूल प्रोफ़ाइल में बंडल MCP टूल डिफ़ॉल्ट रूप से शामिल होते हैं; किसी एजेंट या Gateway के लिए बाहर रहने हेतु tools.deny: ["bundle-mcp"] का उपयोग करें
• प्रोजेक्ट-local एम्बेडेड एजेंट सेटिंग्स बंडल डिफ़ॉल्ट के बाद भी लागू होती हैं, इसलिए ज़रूरत पड़ने पर workspace सेटिंग्स बंडल MCP एंट्री को ओवरराइड कर सकती हैं
• बंडल MCP टूल कैटलॉग रजिस्ट्रेशन से पहले निर्धारक रूप से सॉर्ट किए जाते हैं, इसलिए upstream listTools() क्रम में बदलाव prompt-cache टूल ब्लॉक को अस्त-व्यस्त नहीं करते

ट्रांसपोर्ट

MCP सर्वर stdio या HTTP ट्रांसपोर्ट का उपयोग कर सकते हैं:

Stdio एक चाइल्ड प्रोसेस लॉन्च करता है:

{  "mcp": {    "servers": {      "my-server": {        "command": "node",        "args": ["server.js"],        "env": { "PORT": "3000" }      }    }  }}

HTTP डिफ़ॉल्ट रूप से sse पर, या अनुरोध किए जाने पर streamable-http पर चल रहे MCP सर्वर से कनेक्ट करता है:

{  "mcp": {    "servers": {      "my-server": {        "url": "http://localhost:3100/mcp",        "transport": "streamable-http",        "headers": {          "Authorization": "Bearer ${MY_SECRET_TOKEN}"        },        "connectionTimeoutMs": 30000      }    }  }}

• transport को "streamable-http" या "sse" पर सेट किया जा सकता है; छोड़े जाने पर, OpenClaw sse का उपयोग करता है
• type: "http" एक CLI-नेटिव downstream आकार है; OpenClaw कॉन्फ़िग में transport: "streamable-http" का उपयोग करें। openclaw mcp set और openclaw doctor --fix सामान्य alias को normalize करते हैं।
• केवल http: और https: URL स्कीम की अनुमति है
• headers वैल्यू ${ENV_VAR} interpolation का समर्थन करती हैं
• command और url दोनों वाली सर्वर एंट्री अस्वीकार कर दी जाती है
• URL क्रेडेंशियल (userinfo और query params) टूल विवरण और लॉग से redact किए जाते हैं
• connectionTimeoutMs stdio और HTTP दोनों ट्रांसपोर्ट के लिए डिफ़ॉल्ट 30-सेकंड कनेक्शन टाइमआउट को ओवरराइड करता है

टूल नामकरण

OpenClaw बंडल MCP टूल को provider-safe नामों के साथ serverName__toolName रूप में रजिस्टर करता है। उदाहरण के लिए, "vigil-harbor" कुंजी वाला सर्वर जो memory_search टूल उपलब्ध कराता है, vigil-harbor__memory_search के रूप में रजिस्टर होता है।

• A-Za-z0-9_- से बाहर के वर्णों को - से बदला जाता है
• जो फ्रैगमेंट non-letter से शुरू होते, उन्हें letter prefix मिलता है, इसलिए 12306 जैसी numeric सर्वर कुंजियां provider-safe टूल prefix बन जाती हैं
• सर्वर prefix 30 वर्णों तक सीमित हैं
• पूरे टूल नाम 64 वर्णों तक सीमित हैं
• खाली सर्वर नाम mcp पर fall back करते हैं
• टकराने वाले sanitized नामों को numeric suffix से अलग किया जाता है
• अंतिम exposed टूल क्रम safe name के अनुसार निर्धारक होता है ताकि दोहराए गए embedded-agent टर्न cache-stable रहें
• प्रोफ़ाइल फ़िल्टरिंग एक बंडल MCP सर्वर के सभी टूल को bundle-mcp द्वारा plugin-owned मानती है, इसलिए प्रोफ़ाइल allowlists और deny lists में व्यक्तिगत exposed टूल नाम या bundle-mcp Plugin कुंजी शामिल हो सकती है

एम्बेडेड OpenClaw सेटिंग्स

• बंडल सक्षम होने पर Claude settings.json को डिफ़ॉल्ट एम्बेडेड OpenClaw सेटिंग्स के रूप में इम्पोर्ट किया जाता है
• OpenClaw shell override keys लागू करने से पहले उन्हें sanitize करता है

Sanitized keys:

• shellPath
• shellCommandPrefix

एम्बेडेड OpenClaw LSP

• सक्षम Claude बंडल LSP सर्वर कॉन्फ़िग दे सकते हैं
• OpenClaw .lsp.json और किसी भी manifest-declared lspServers पथ को लोड करता है
• बंडल LSP कॉन्फ़िग को प्रभावी एम्बेडेड OpenClaw LSP डिफ़ॉल्ट में मर्ज किया जाता है
• आज केवल समर्थित stdio-backed LSP सर्वर चलाए जा सकते हैं; unsupported ट्रांसपोर्ट फिर भी openclaw plugins inspect <id> में दिखते हैं

पहचाना गया लेकिन चलाया नहीं गया

इन्हें पहचाना जाता है और diagnostics में दिखाया जाता है, लेकिन OpenClaw इन्हें नहीं चलाता:

• Claude agents, hooks.json automation, outputStyles
• Cursor .cursor/agents, .cursor/hooks.json, .cursor/rules
• Codex inline/app metadata, capability reporting से परे

बंडल फ़ॉर्मैट

पहचान प्राथमिकता

OpenClaw पहले नेटिव Plugin फ़ॉर्मैट की जांच करता है:

1. openclaw.plugin.json या openclaw.extensions वाला वैध package.json — नेटिव Plugin माना जाता है
2. बंडल मार्कर (.codex-plugin/, .claude-plugin/, या डिफ़ॉल्ट Claude/Cursor लेआउट) — बंडल माना जाता है

यदि किसी डायरेक्टरी में दोनों मौजूद हैं, तो OpenClaw नेटिव पथ का उपयोग करता है। इससे dual-format पैकेज को आंशिक रूप से बंडल के रूप में इंस्टॉल होने से रोका जाता है।

Runtime dependencies और cleanup

• Third-party compatible बंडल को startup npm install repair नहीं मिलता। उन्हें openclaw plugins install के ज़रिए इंस्टॉल किया जाना चाहिए और installed Plugin directory में अपनी सभी ज़रूरी चीज़ें शिप करनी चाहिए।
• OpenClaw-owned bundled Plugin या तो core में lightweight रूप से शिप किए जाते हैं या Plugin installer के ज़रिए डाउनलोड किए जा सकते हैं। Gateway startup उनके लिए कभी package manager नहीं चलाता।
• openclaw doctor --fix legacy staged dependency directories हटाता है और config में reference होने पर local Plugin index से गायब downloadable Plugin को recover कर सकता है।

सुरक्षा

बंडल की trust boundary नेटिव Plugin से सीमित होती है:

• OpenClaw arbitrary bundle runtime modules को in-process लोड नहीं करता
• Skills और hook-pack paths को Plugin root के अंदर ही रहना चाहिए (boundary-checked)
• Settings files समान boundary checks के साथ पढ़ी जाती हैं
• समर्थित stdio MCP सर्वर subprocess के रूप में लॉन्च किए जा सकते हैं

इससे बंडल डिफ़ॉल्ट रूप से अधिक सुरक्षित बनते हैं, लेकिन फिर भी आपको third-party बंडल को उनके द्वारा expose की गई सुविधाओं के लिए trusted content मानना चाहिए।

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

संबंधित

• Plugin इंस्टॉल और कॉन्फ़िगर करें
• Plugin बनाना — नेटिव Plugin बनाएं
• Plugin मैनिफ़ेस्ट — नेटिव मैनिफ़ेस्ट schema