Skip to main content
Plugin SDK में संकीर्ण सार्वजनिक सबपाथ और केवल रिपॉज़िटरी के लिए बंडल किए गए सहायक openclaw/plugin-sdk/ के अंतर्गत हैं। यह पृष्ठ दोनों को सूचीबद्ध करता है और निजी-स्थानीय प्रविष्टियों को स्पष्ट रूप से चिह्नित करता है। तीन फ़ाइलें सीमा निर्धारित करती हैं:
  • scripts/lib/plugin-sdk-entrypoints.json: अनुरक्षित एंट्रीपॉइंट सूची जिसे बिल्ड कंपाइल करता है।
  • scripts/lib/plugin-sdk-private-local-only-subpaths.json: टाइप किए गए, प्रलेखित SDK से बाहर रखे गए आंतरिक सबपाथ। अलग से प्रकाशित आधिकारिक plugins के लिए उत्पादन प्रविष्टियाँ केवल JavaScript होस्ट रनटाइम एक्सपोर्ट के रूप में उपलब्ध रहती हैं; केवल-परीक्षण प्रविष्टियाँ एक्सपोर्ट नहीं की जातीं।
  • src/plugin-sdk/entrypoints.ts: अप्रचलित सबपाथ, आरक्षित बंडल सहायक, समर्थित बंडल फ़साड और Plugin-स्वामित्व वाली सार्वजनिक सतहों के लिए वर्गीकरण मेटाडेटा।
अनुरक्षक सार्वजनिक एक्सपोर्ट की संख्या का ऑडिट pnpm plugin-sdk:surface से और सक्रिय आरक्षित सहायक सबपाथ का ऑडिट pnpm plugins:boundary-report:summary से करते हैं; अप्रयुक्त आरक्षित सहायक एक्सपोर्ट निष्क्रिय संगतता ऋण के रूप में सार्वजनिक SDK में बने रहने के बजाय CI रिपोर्ट को विफल कर देते हैं। Plugin लेखन मार्गदर्शिका के लिए, Plugin SDK अवलोकन देखें।

Plugin प्रविष्टि

संगतता और निजी-स्थानीय सहायक

केवल बाद की अवधि में अप्रचलित किए गए सबपाथ एक्सपोर्ट बने हुए हैं। जुलाई 2026 के उपनाम और अप्रयुक्त सबपाथ हटा दिए गए, जबकि केवल-बंडल सहायक सार्वजनिक पैकेज से हटा दिए गए और नीचे निजी-स्थानीय चिह्नित हैं। अनुरक्षित सूची scripts/lib/plugin-sdk-deprecated-public-subpaths.json है; CI बंडल किए गए plugin-sdk/text-runtime को अस्वीकार करता है, जो केवल संगतता के लिए हैं, और plugin-sdk/zod एक संगतता पुनः-एक्सपोर्ट है: zod को सीधे zod से आयात करें। व्यापक डोमेन बैरल plugin-sdk/agent-runtime, plugin-sdk/channel-lifecycle, plugin-sdk/conversation-runtime, plugin-sdk/hook-runtime, plugin-sdk/media-runtime, plugin-sdk/plugin-runtime और plugin-sdk/security-runtime भी केंद्रित सबपाथ के पक्ष में अप्रचलित हैं। OpenClaw के Vitest-समर्थित परीक्षण-सहायक सबपाथ केवल रिपॉज़िटरी-स्थानीय हैं और अब पैकेज एक्सपोर्ट नहीं हैं: agent-runtime-test-contracts, channel-contract-testing, channel-target-testing, channel-test-helpers, plugin-state-test-runtime, plugin-test-api, plugin-test-contracts, plugin-test-runtime, provider-http-test-mocks, provider-test-contracts, reply-payload-testing, sqlite-runtime-testing, test-env, test-fixtures, test-live, test-live-auth, test-media-generation, test-media-understanding, test-node-mocks और testing। निजी बंडल सहायक सतहें ssrf-runtime-internal और codex-native-task-runtime भी केवल रिपॉज़िटरी-स्थानीय हैं।

बंडल किए गए Plugin सहायक सबपाथ

केवल-बंडल सहायक मॉड्यूल जुलाई 2026 की समीक्षा के बाद निजी-स्थानीय हैं। विभिन्न स्वामियों के बीच आयात पैकेज अनुबंध सुरक्षा-सीमाओं द्वारा अवरुद्ध हैं। src/plugin-sdk/entrypoints.ts उन समर्थित बंडल फ़साड को अलग से ट्रैक करता है जो सार्वजनिक बने हुए हैं—वे SDK एंट्रीपॉइंट जिन्हें सामान्य अनुबंधों द्वारा प्रतिस्थापित किए जाने तक उनके बंडल किए गए Plugin का समर्थन प्राप्त है। plugin-sdk/qa-runner-runtime, plugin-sdk/telegram-account, नए कोड के लिए अप्रचलित हैं; नीचे प्रत्येक पंक्ति के नोट देखें।
बाद की अवधि वाले चैनल संगतता सबपाथ केवल अपनी रजिस्ट्री तिथियों तक सार्वजनिक रहते हैं। प्रत्यक्ष-DM पहुँच, उत्तर-विकल्प, पेयरिंग पाथ और चैनल रनटाइम खंडों जैसे जुलाई उपनाम हटा दिए गए हैं; केवल-बंडल सहायक निजी-स्थानीय हैं।
प्रदाता उपयोग स्नैपशॉट सामान्यतः एक या अधिक कोटा windows रिपोर्ट करते हैं, जिनमें प्रत्येक के साथ एक लेबल, उपयोग किया गया प्रतिशत और वैकल्पिक रीसेट समय होता है। जो प्रदाता रीसेट किए जा सकने वाले कोटा विंडो के बजाय शेषराशि या खाता-स्थिति पाठ प्रदर्शित करते हैं, उन्हें काल्पनिक प्रतिशत बनाने के बजाय रिक्त windows सरणी के साथ summary लौटाना चाहिए। OpenClaw उस सारांश पाठ को स्थिति आउटपुट में प्रदर्शित करता है; error का उपयोग केवल तब करें जब उपयोग एंडपॉइंट विफल हो गया हो या उसने कोई उपयोगी उपयोग डेटा न लौटाया हो।
आरक्षित बंडल-हेल्पर SDK उपपथ बंडल किए गए Plugin कोड के लिए सीमित स्वामी-विशिष्ट सतहें हैं। इन्हें SDK इन्वेंट्री में ट्रैक किया जाता है ताकि पैकेज बिल्ड और एलियासिंग नियतात्मक रहें, लेकिन ये सामान्य Plugin लेखन API नहीं हैं। नए पुन: प्रयोज्य होस्ट अनुबंधों को सामान्य SDK उपपथों का उपयोग करना चाहिए, जैसे plugin-sdk/gateway-runtime और plugin-sdk/ssrf-runtime

संबंधित