Plugin reference
Plugin इंस्टॉल ओवरराइड्स
Plugin इंस्टॉल ओवरराइड अनुरक्षकों को सेटअप-समय Plugin इंस्टॉल के लिए कैटलॉग,
बंडल किए गए या डिफ़ॉल्ट npm स्रोत के बजाय किसी विशिष्ट npm पैकेज या स्थानीय npm-pack
टारबॉल का उपयोग करने देते हैं। ये केवल E2E और पैकेज सत्यापन के लिए हैं; सामान्य
उपयोगकर्ता openclaw plugins install से Plugin इंस्टॉल करते हैं।
परिवेश
जब तक दोनों वेरिएबल सेट न हों, ओवरराइड अक्षम रहते हैं:
export OPENCLAW_ALLOW_PLUGIN_INSTALL_OVERRIDES=1export OPENCLAW_PLUGIN_INSTALL_OVERRIDES='{ "codex": "npm-pack:/tmp/openclaw-codex-2026.5.8.tgz", "openclaw-web-search": "npm:@openclaw/web-search@2026.5.8"}'ओवरराइड मैप JSON है, जिसकी कुंजियाँ Plugin id हैं। मान इनमें से हो सकते हैं:
| उपसर्ग | स्रोत |
|---|---|
npm:<registry-spec> |
रजिस्ट्री पैकेज, सटीक वर्ज़न या टैग |
npm-pack:<path.tgz> |
npm pack द्वारा बनाए गए स्थानीय टारबॉल; सापेक्ष पाथ वर्तमान कार्यशील डायरेक्टरी से रिज़ॉल्व होते हैं |
व्यवहार
जब सेटअप-समय का कोई प्रवाह ऐसे Plugin को इंस्टॉल करता है जिसकी id मैप में मौजूद है, तो OpenClaw कैटलॉग, बंडल किए गए या डिफ़ॉल्ट npm स्रोत के बजाय ओवरराइड स्रोत का उपयोग करता है। यह ऑनबोर्डिंग और साझा सेटअप-समय Plugin इंस्टॉलर का उपयोग करने वाले किसी भी अन्य प्रवाह पर लागू होता है।
- ओवरराइड अब भी अपेक्षित Plugin id लागू करते हैं:
codexसे मैप किया गया टारबॉल ऐसा Plugin इंस्टॉल करना चाहिए जिसकी मेनिफ़ेस्ट idcodexहो। - ओवरराइड आधिकारिक विश्वसनीय-स्रोत स्थिति इनहेरिट नहीं करते। भले ही कैटलॉग प्रविष्टि सामान्यतः OpenClaw के स्वामित्व वाले पैकेज को दर्शाती हो, ओवरराइड को ऑपरेटर द्वारा दी गई परीक्षण इनपुट माना जाता है।
- वर्कस्पेस की
.envफ़ाइलें इंस्टॉल ओवरराइड सक्षम नहीं कर सकतीं; दोनों env var अवरुद्ध वर्कस्पेस dotenv सूची में हैं। उन्हें उस विश्वसनीय shell, CI जॉब या रिमोट परीक्षण कमांड में सेट करें जो OpenClaw लॉन्च करता है।
पैकेज E2E
पृथक स्टेट डायरेक्टरी का उपयोग करें, ताकि पैकेज इंस्टॉल और इंस्टॉल रिकॉर्ड आपकी सामान्य OpenClaw स्टेट को प्रभावित न करें:
npm pack extensions/codex --pack-destination /tmp OPENCLAW_STATE_DIR="$(mktemp -d)" \OPENCLAW_ALLOW_PLUGIN_INSTALL_OVERRIDES=1 \OPENCLAW_PLUGIN_INSTALL_OVERRIDES='{"codex":"npm-pack:/tmp/openclaw-codex-2026.5.8.tgz"}' \pnpm openclaw onboard --mode localस्टेट डायरेक्टरी के अंतर्गत इंस्टॉल किए गए पैकेज को सत्यापित करें:
find "$OPENCLAW_STATE_DIR/npm/projects" -path '*/node_modules/@openclaw/codex/package.json' -printgrep -R '"@openclaw/codex"' "$OPENCLAW_STATE_DIR/npm/projects"/*/package-lock.jsonलाइव प्रोवाइडर E2E के लिए, परीक्षण कमांड लॉन्च करने से पहले वास्तविक API कुंजी को किसी विश्वसनीय shell या CI secret से लोड करें। कुंजियाँ प्रिंट न करें; केवल स्रोत और यह रिपोर्ट करें कि कुंजी मौजूद थी या नहीं।
