Plugin बंडल

​

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

​

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

# स्थानीय डायरेक्टरी
openclaw plugins install ./my-bundle

# आर्काइव
openclaw plugins install ./my-bundle.tgz

# Claude मार्केटप्लेस
openclaw plugins marketplace list <source>
openclaw plugins install <plugin> --marketplace <source>

openclaw plugins list
openclaw plugins inspect <id>

openclaw gateway restart

​

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

​

अभी समर्थित

​

Skill कंटेंट

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

​

Hook पैक

​

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

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

ट्रांसपोर्ट

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

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

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

टूल नामकरण

• A-Za-z0-9_- के बाहर के वर्णों को - से बदल दिया जाता है।
• जो खंड किसी अक्षर के अलावा किसी अन्य वर्ण से शुरू होते, उनमें अक्षर उपसर्ग जोड़ा जाता है, ताकि 12306 जैसी संख्यात्मक सर्वर कुंजियाँ प्रदाता-सुरक्षित टूल उपसर्ग बनें।
• सर्वर उपसर्ग अधिकतम 30 वर्ण के होते हैं।
• पूरे टूल नाम अधिकतम 64 वर्ण के होते हैं।
• खाली सर्वर नामों के लिए mcp का उपयोग किया जाता है।
• टकराने वाले स्वच्छीकृत नामों को संख्यात्मक प्रत्ययों से अलग किया जाता है।
• अंततः उपलब्ध टूल का क्रम सुरक्षित नाम के अनुसार नियतात्मक होता है, जिससे बार-बार होने वाले एम्बेडेड-agent टर्न में कैश स्थिर रहता है।
• प्रोफ़ाइल फ़िल्टरिंग एक बंडल MCP सर्वर के प्रत्येक टूल को bundle-mcp के स्वामित्व वाला plugin मानती है, इसलिए प्रोफ़ाइल अनुमति/निषेध सूचियाँ अलग-अलग उपलब्ध टूल नामों या bundle-mcp plugin कुंजी को संदर्भित कर सकती हैं।

​

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

• shellPath
• shellCommandPrefix

​

एम्बेडेड OpenClaw LSP

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

​

पहचाने गए, लेकिन निष्पादित नहीं

• Claude agents, hooks/hooks.json ऑटोमेशन, outputStyles
• Cursor .cursor/agents, .cursor/hooks.json, .cursor/rules
• क्षमता रिपोर्टिंग से परे Codex .app.json मेटाडेटा

​

बंडल प्रारूप

​

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

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

​

रनटाइम निर्भरताएँ और सफ़ाई

• तृतीय-पक्ष संगत बंडल को स्टार्टअप npm install सुधार नहीं मिलता। उन्हें openclaw plugins install के माध्यम से इंस्टॉल किया जाना चाहिए और आवश्यक सभी सामग्री इंस्टॉल की गई plugin डायरेक्टरी में ही भेजनी चाहिए।
• OpenClaw के स्वामित्व वाले बंडल plugins या तो core में हल्के रूप में भेजे जाते हैं या plugin इंस्टॉलर के माध्यम से डाउनलोड किए जा सकते हैं। Gateway स्टार्टअप उनके लिए कभी पैकेज मैनेजर नहीं चलाता।
• openclaw doctor --fix पुराने स्थानीय बंडल-plugin इंस्टॉलेशन रिकॉर्ड हटाता है और यदि कॉन्फ़िग अब भी उनका संदर्भ देता हो, तो स्थानीय plugin इंडेक्स से गायब डाउनलोड-योग्य plugins को पुनर्प्राप्त कर सकता है।

​

सुरक्षा

• OpenClaw मनमाने बंडल रनटाइम मॉड्यूल को इन-प्रोसेस लोड नहीं करता।
• Skills और hook-पैक पथ plugin रूट के भीतर ही होने चाहिए (सीमा की जाँच की जाती है)।
• सेटिंग फ़ाइलें समान सीमा जाँच के साथ पढ़ी जाती हैं।
• समर्थित stdio MCP सर्वर उप-प्रक्रियाओं के रूप में शुरू किए जा सकते हैं।

​

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

​

संबंधित

• Plugin इंस्टॉल और कॉन्फ़िगर करें
• Plugin बनाना - एक नेटिव Plugin बनाएँ
• Plugin मेनिफ़ेस्ट - नेटिव मेनिफ़ेस्ट स्कीमा