Plugin प्रबंधित करें

सामान्य Plugin प्रबंधन कमांड के लिए इस पेज का उपयोग करें। संपूर्ण कमांड कॉन्ट्रैक्ट, फ्लैग, स्रोत-चयन नियमों, और किनारे के मामलों के लिए, openclaw plugins देखें।

अधिकांश इंस्टॉल वर्कफ़्लो ये हैं:

1. कोई पैकेज खोजें
2. उसे ClawHub, npm, git, या स्थानीय पाथ से इंस्टॉल करें
3. प्रबंधित Gateway को अपने-आप रीस्टार्ट होने दें, या अप्रबंधित होने पर उसे मैन्युअल रूप से रीस्टार्ट करें
4. Plugin के रनटाइम पंजीकरणों को सत्यापित करें

Plugin सूचीबद्ध करें और खोजें

openclaw plugins listopenclaw plugins list --enabledopenclaw plugins list --verboseopenclaw plugins list --jsonopenclaw plugins search "calendar"

स्क्रिप्ट के लिए --json का उपयोग करें:

openclaw plugins list --json \  | jq '.plugins[] | {id, enabled, format, source, dependencyStatus}'

plugins list एक कोल्ड इन्वेंटरी जांच है। यह दिखाता है कि OpenClaw कॉन्फ़िग, मैनिफ़ेस्ट, और Plugin रजिस्ट्री से क्या खोज सकता है; यह साबित नहीं करता कि पहले से चल रहे Gateway ने Plugin रनटाइम इंपोर्ट किया है। JSON आउटपुट में रजिस्ट्री डायग्नॉस्टिक्स और हर Plugin का स्थिर dependencyStatus शामिल होता है, जब Plugin पैकेज dependencies या optionalDependencies घोषित करता है।

plugins search इंस्टॉल किए जा सकने वाले Plugin पैकेज के लिए ClawHub को क्वेरी करता है और openclaw plugins install clawhub:<package> जैसे इंस्टॉल संकेत प्रिंट करता है।

Plugin इंस्टॉल करें

# Search ClawHub for plugin packages.openclaw plugins search "calendar" # Install from ClawHub.openclaw plugins install clawhub:<package>openclaw plugins install clawhub:<package>@1.2.3openclaw plugins install clawhub:<package>@beta # Install from npm.openclaw plugins install npm:<package>openclaw plugins install npm:@scope/openclaw-plugin@1.2.3openclaw plugins install npm:@openclaw/codex # Install from a local npm pack artifact.openclaw plugins install npm-pack:<path.tgz> # Install from git or a local development checkout.openclaw plugins install git:github.com/acme/openclaw-plugin@v1.0.0openclaw plugins install ./my-pluginopenclaw plugins install --link ./my-plugin

लॉन्च कटओवर के दौरान नंगे पैकेज स्पेक npm से इंस्टॉल होते हैं। जब आपको निर्धारित स्रोत चयन चाहिए, तो clawhub:, npm:, git:, या npm-pack: का उपयोग करें। अगर नंगा नाम किसी आधिकारिक Plugin id से मेल खाता है, तो OpenClaw कैटलॉग प्रविष्टि को सीधे इंस्टॉल कर सकता है।

--force का उपयोग केवल तब करें जब आप जानबूझकर किसी मौजूदा इंस्टॉल लक्ष्य को ओवरराइट करना चाहते हों। ट्रैक किए गए npm, ClawHub, या hook-pack इंस्टॉल के नियमित अपग्रेड के लिए, openclaw plugins update का उपयोग करें।

रीस्टार्ट करें और निरीक्षण करें

Plugin कोड इंस्टॉल, अपडेट, या अनइंस्टॉल करने के बाद, कॉन्फ़िग रीलोड सक्षम होने पर चल रहा प्रबंधित Gateway अपने-आप रीस्टार्ट हो जाता है। अगर Gateway प्रबंधित नहीं है या रीलोड अक्षम है, तो लाइव रनटाइम सतहें जांचने से पहले उसे खुद रीस्टार्ट करें:

openclaw gateway restartopenclaw plugins inspect <plugin-id> --runtime --json

जब आपको यह प्रमाण चाहिए कि Plugin ने टूल, हुक, सेवाएं, Gateway मेथड, HTTP रूट, या Plugin-स्वामित्व वाले CLI कमांड जैसी रनटाइम सतहें पंजीकृत की हैं, तो inspect --runtime का उपयोग करें। सामान्य inspect और list कोल्ड मैनिफ़ेस्ट, कॉन्फ़िग, और रजिस्ट्री जांचें हैं।

Plugin अपडेट करें

openclaw plugins update <plugin-id>openclaw plugins update <npm-package-or-spec>openclaw plugins update --allopenclaw plugins update <plugin-id> --dry-run

जब आप कोई Plugin id पास करते हैं, तो OpenClaw ट्रैक किए गए इंस्टॉल स्पेक का दोबारा उपयोग करता है। संग्रहीत dist-tags जैसे @beta और सटीक पिन किए गए संस्करण बाद के update <plugin-id> रन में भी उपयोग किए जाते रहते हैं।

openclaw plugins update --all बल्क रखरखाव पाथ है। यह फिर भी सामान्य ट्रैक किए गए इंस्टॉल स्पेक का सम्मान करता है, लेकिन विश्वसनीय आधिकारिक OpenClaw Plugin रिकॉर्ड किसी पुराने सटीक आधिकारिक पैकेज पर रहने के बजाय मौजूदा आधिकारिक कैटलॉग लक्ष्य से सिंक कर सकते हैं। अगर update.channel को beta पर सेट किया गया है, तो वह बल्क आधिकारिक सिंक beta-channel संदर्भ का उपयोग करता है। जब आप जानबूझकर किसी सटीक या टैग किए गए आधिकारिक स्पेक को अनछुआ रखना चाहते हों, तो लक्षित update <plugin-id> का उपयोग करें।

npm इंस्टॉल के लिए, ट्रैक किए गए रिकॉर्ड को बदलने के लिए आप स्पष्ट पैकेज स्पेक पास कर सकते हैं:

openclaw plugins update @scope/openclaw-plugin@betaopenclaw plugins update @scope/openclaw-plugin

दूसरा कमांड किसी Plugin को रजिस्ट्री की डिफ़ॉल्ट रिलीज़ लाइन पर वापस ले जाता है, जब वह पहले किसी सटीक संस्करण या टैग पर पिन किया गया था।

जब openclaw update beta चैनल पर चलता है, तो Plugin रिकॉर्ड मिलती-जुलती @beta रिलीज़ को प्राथमिकता दे सकते हैं। सटीक फ़ॉलबैक और पिनिंग नियमों के लिए, openclaw plugins देखें।

Plugin अनइंस्टॉल करें

openclaw plugins uninstall <plugin-id> --dry-runopenclaw plugins uninstall <plugin-id>openclaw plugins uninstall <plugin-id> --keep-files

अनइंस्टॉल Plugin की कॉन्फ़िग प्रविष्टि, स्थायी Plugin इंडेक्स रिकॉर्ड, allow/deny सूची प्रविष्टियां, और लागू होने पर लिंक किए गए लोड पाथ हटाता है। प्रबंधित इंस्टॉल डायरेक्टरी हटा दी जाती हैं, जब तक आप --keep-files पास नहीं करते। जब अनइंस्टॉल Plugin स्रोत बदलता है, तो चल रहा प्रबंधित Gateway अपने-आप रीस्टार्ट हो जाता है।

Nix मोड (OPENCLAW_NIX_MODE=1) में, Plugin इंस्टॉल, अपडेट, अनइंस्टॉल, सक्षम, और अक्षम करने वाले कमांड अक्षम होते हैं। इसके बजाय इंस्टॉल के लिए Nix स्रोत में उन विकल्पों को प्रबंधित करें।

स्रोत चुनें

प्रबंधित स्थानीय पाथ इंस्टॉल Plugin डायरेक्टरी या आर्काइव होने चाहिए। स्वतंत्र Plugin फ़ाइलों को plugins install से इंस्टॉल करने के बजाय plugins.load.paths में रखें।

Plugin प्रकाशित करें

ClawHub OpenClaw Plugin के लिए प्राथमिक सार्वजनिक खोज सतह है। जब आप चाहते हैं कि उपयोगकर्ता इंस्टॉल करने से पहले Plugin मेटाडेटा, संस्करण इतिहास, रजिस्ट्री स्कैन परिणाम, और इंस्टॉल संकेत खोज सकें, तो वहां प्रकाशित करें।

npm i -g clawhubclawhub loginclawhub package publish your-org/your-plugin --dry-runclawhub package publish your-org/your-pluginclawhub package publish your-org/your-plugin@v1.0.0

नेटिव npm Plugin में प्रकाशित करने से पहले Plugin मैनिफ़ेस्ट और पैकेज मेटाडेटा शामिल होना चाहिए:

{  "name": "@acme/openclaw-plugin",  "version": "1.0.0",  "type": "module",  "openclaw": {    "extensions": ["./dist/index.js"]  }}

npm publish --access publicopenclaw plugins install npm:@acme/openclaw-pluginopenclaw plugins install npm:@acme/openclaw-plugin@betaopenclaw plugins install npm:@acme/openclaw-plugin@1.0.0

इस पेज को प्रकाशन संदर्भ मानने के बजाय, पूर्ण प्रकाशन कॉन्ट्रैक्ट के लिए इन पेजों का उपयोग करें:

• ClawHub प्रकाशन owners, scopes, releases, review, package validation, और package transfer समझाता है।
• Plugin बनाना Plugin पैकेज का आकार और पहला publish वर्कफ़्लो दिखाता है।
• Plugin मैनिफ़ेस्ट नेटिव Plugin मैनिफ़ेस्ट फ़ील्ड परिभाषित करता है।

अगर वही पैकेज ClawHub और npm दोनों पर उपलब्ध है, तो जब आपको किसी एक स्रोत को बलपूर्वक चुनना हो, स्पष्ट clawhub: या npm: प्रीफ़िक्स का उपयोग करें।

संबंधित

• Plugin - इंस्टॉल, कॉन्फ़िगर, रीस्टार्ट, और समस्या निवारण
• openclaw plugins - पूर्ण CLI संदर्भ
• समुदाय Plugin - सार्वजनिक खोज और ClawHub प्रकाशन
• ClawHub - रजिस्ट्री CLI ऑपरेशन
• Plugin बनाना - Plugin पैकेज बनाएं
• Plugin मैनिफ़ेस्ट - मैनिफ़ेस्ट और पैकेज मेटाडेटा