प्रकाशन

प्रकाशन किसी Skills फ़ोल्डर या Plugin पैकेज को आपके द्वारा चुने गए स्वामी के अंतर्गत ClawHub पर भेजता है। ClawHub जाँचता है कि आपका टोकन उस स्वामी के लिए प्रकाशन कर सकता है, मेटाडेटा, नाम, संस्करण, फ़ाइलों और स्रोत की जानकारी को सत्यापित करता है, फिर रिलीज़ को संग्रहीत करके स्वचालित सुरक्षा जाँच शुरू करता है।

यदि सत्यापन विफल होता है, तो कुछ भी प्रकाशित नहीं किया जाता। नई रिलीज़ समीक्षा पूरी होने तक सामान्य इंस्टॉल और डाउनलोड माध्यमों पर भी उपलब्ध नहीं हो सकती हैं।

Skills

प्रकाशित करने का सबसे सरल तरीका CLI है। साइन इन करें, फिर स्थानीय Skills फ़ोल्डर प्रकाशित करें:

clawhub loginclawhub skill publish ./my-skill \  --slug my-skill \  --name "My Skill" \  --owner <owner>

किसी संगठन के स्वामी के अंतर्गत प्रकाशित करते समय --owner <handle> का उपयोग करें। प्रमाणित उपयोगकर्ता के रूप में प्रकाशित करने के लिए इसे छोड़ दें। प्रकाशन के दौरान अपरिवर्तित सामग्री छोड़ दी जाती है। नया Skills 1.0.0 से शुरू होता है, और बाद के परिवर्तन स्वचालित रूप से अगला पैच संस्करण प्रकाशित करते हैं। केवल स्पष्ट संस्करण की आवश्यकता होने पर --version दें।

कैटलॉग रिपॉज़िटरी के लिए ClawHub के पुनः उपयोग योग्य skill-publish.yml वर्कफ़्लो का उपयोग करें। यह root (डिफ़ॉल्ट: skills) के ठीक अंतर्गत आने वाले प्रत्येक Skills फ़ोल्डर के लिए skill publish को कॉल करता है, या केवल skill_path के रूप में दिए गए फ़ोल्डर के लिए।

jobs:  publish:    uses: openclaw/clawhub/.github/workflows/skill-publish.yml@main    with:      owner: <owner>      dry_run: false    secrets:      clawhub_token: ${{ secrets.CLAWHUB_TOKEN }}

प्रकाशित किए बिना नए और परिवर्तित Skills का पूर्वावलोकन करने के लिए dry_run: true का उपयोग करें।

Plugins

Plugins npm-शैली के पैकेज नामों का उपयोग करते हैं। स्कोप वाले पैकेज नामों के पहले भाग में स्वामी शामिल होता है:

@owner/package-name

स्कोप चयनित प्रकाशन स्वामी से मेल खाना चाहिए। यदि आपके पैकेज का नाम @openclaw/dronzer है, तो इसे केवल @openclaw के रूप में प्रकाशित किया जा सकता है। यदि आप @vintageayu के रूप में प्रकाशित करते हैं, तो पैकेज का नाम बदलकर @vintageayu/dronzer करें।

यह किसी पैकेज को ऐसे संगठन नेमस्पेस पर दावा करने से रोकता है जिस पर प्रकाशक का नियंत्रण नहीं है।

यदि आप किसी ऐसे संगठन, ब्रांड, पैकेज स्कोप, स्वामी हैंडल या नेमस्पेस के वास्तविक स्वामी हैं जिस पर ClawHub में पहले ही दावा किया गया है या जिसे आरक्षित किया गया है, तो सार्वजनिक और गैर-संवेदनशील प्रमाण के साथ संगठन / नेमस्पेस दावे की समस्या खोलें। क्या शामिल करना है और सार्वजनिक समस्याओं से क्या बाहर रखना है, इसके लिए संगठन और नेमस्पेस दावे देखें।

Plugin प्रकाशित करने से पहले

• ऐसा स्वामी चुनें जो पैकेज स्कोप से मेल खाता हो।
• openclaw.plugin.json शामिल करें। कोड Plugins के लिए openclaw.compat.pluginApi और openclaw.build.openclawVersion सहित package.json भी आवश्यक है।
• मुखपृष्ठ और Plugin सूची पृष्ठों पर कस्टम Plugin कैटलॉग आइकन दिखाने के लिए, किसी भी HTTPS छवि URL के साथ openclaw.plugin.json में icon जोड़ें।
• स्रोत रिपॉज़िटरी और सटीक कमिट मेटाडेटा शामिल करें, या GitHub-समर्थित चेकआउट से CLI का उपयोग करें ताकि वह उनका पता लगा सके।
• प्रकाशित करने से पहले clawhub package validate <source> चलाएँ। पैकेज, मैनिफ़ेस्ट, SDK इंपोर्ट या आर्टिफ़ैक्ट संबंधी निष्कर्षों के लिए Plugin सत्यापन सुधार देखें।
• रिलीज़ बनाने से पहले clawhub package publish <source> --dry-run चलाएँ।
• नई रिलीज़ के स्वचालित सुरक्षा जाँच और सत्यापन पूरा होने तक सार्वजनिक इंस्टॉल माध्यमों से बाहर रहने की अपेक्षा करें।

पैकेजों के लिए विश्वसनीय प्रकाशन

पैकेज का विश्वसनीय प्रकाशन दो चरणों में सेट अप होता है:

1. पैकेज को सामान्य मैन्युअल या टोकन-प्रमाणित clawhub package publish के माध्यम से एक बार प्रकाशित करें। इससे पैकेज पंक्ति बनती है और वे पैकेज प्रबंधक निर्धारित होते हैं जो इसके विश्वसनीय प्रकाशक कॉन्फ़िगरेशन को बदल सकते हैं।
2. एक पैकेज प्रबंधक GitHub Actions का विश्वसनीय प्रकाशक कॉन्फ़िगरेशन सेट करता है:

clawhub package trusted-publisher set @owner/package-name \  --repository owner/repo \  --workflow-filename package-publish.yml

कॉन्फ़िगरेशन सेट होने के बाद, भविष्य के समर्थित GitHub Actions प्रकाशन रिपॉज़िटरी में लंबे समय तक रहने वाला ClawHub टोकन संग्रहीत किए बिना OIDC/विश्वसनीय प्रकाशन का उपयोग कर सकते हैं। कॉन्फ़िगर की गई रिपॉज़िटरी और वर्कफ़्लो फ़ाइल नाम GitHub Actions के OIDC दावे से मेल खाने चाहिए। यदि आप --environment <name> भी देते हैं, तो GitHub Actions का एनवायरनमेंट दावा उस नाम से बिल्कुल मेल खाना चाहिए।

विश्वसनीय प्रकाशक कॉन्फ़िगरेशन सेट होने पर ClawHub कॉन्फ़िगर की गई GitHub रिपॉज़िटरी को सत्यापित करता है। सार्वजनिक रिपॉज़िटरी को सार्वजनिक GitHub मेटाडेटा के माध्यम से सत्यापित किया जा सकता है। निजी रिपॉज़िटरी के लिए ClawHub के पास उस रिपॉज़िटरी की GitHub पहुँच होना आवश्यक है, उदाहरण के लिए भविष्य में ClawHub GitHub App की स्थापना या किसी अन्य अधिकृत GitHub एकीकरण के माध्यम से।

वर्तमान पुनः उपयोग योग्य पैकेज प्रकाशन वर्कफ़्लो id-token: write उपलब्ध होने पर workflow_dispatch प्रकाशनों के लिए सीक्रेट-रहित विश्वसनीय प्रकाशन का समर्थन करता है। टैग-पुश वाले वास्तविक प्रकाशनों को अभी भी clawhub_token की आवश्यकता होती है, इसलिए टैग रिलीज़, प्रथम प्रकाशन, अविश्वसनीय पैकेज या आपातकालीन प्रकाशनों के लिए CLAWHUB_TOKEN उपलब्ध रखें।

कॉन्फ़िगरेशन का निरीक्षण करने या उसे हटाने के लिए:

clawhub package trusted-publisher get @owner/package-nameclawhub package trusted-publisher delete @owner/package-name

विश्वसनीय प्रकाशक कॉन्फ़िगरेशन को हटाना रोलबैक का तरीका है। यह तब तक भविष्य के विश्वसनीय प्रकाशन टोकन बनाना अक्षम कर देता है, जब तक कोई पैकेज प्रबंधक दोबारा कॉन्फ़िगरेशन सेट नहीं करता।

अक्सर पूछे जाने वाले प्रश्न

पैकेज स्कोप चयनित स्वामी से मेल खाना चाहिए

यदि पैकेज स्कोप और चयनित स्वामी मेल नहीं खाते, तो ClawHub प्रकाशन अस्वीकार कर देता है:

पैकेज स्कोप "@openclaw" चयनित स्वामी "@vintageayu" से मेल खाना चाहिए।"@openclaw" के रूप में प्रकाशित करें या इस पैकेज का नाम बदलकर "@vintageayu/dronzer" करें।

इसे ठीक करने के लिए या तो पैकेज स्कोप में नामित स्वामी चुनें, या पैकेज का नाम बदलें ताकि स्कोप उस स्वामी से मेल खाए जिसके रूप में आप प्रकाशित कर सकते हैं।

यदि पैकेज नाम में पहले से सही स्कोप है लेकिन पैकेज गलत प्रकाशक के स्वामित्व में है, तो इसके बजाय स्वामित्व स्थानांतरित करें:

clawhub package transfer @opik/opik-openclaw --to opik

पैकेज या Skills स्थानांतरण का उपयोग केवल तभी करें जब आपके पास वर्तमान स्वामी और गंतव्य प्रकाशक, दोनों की व्यवस्थापक पहुँच हो। पैकेज स्थानांतरण आपको ऐसे स्कोप में प्रकाशित करने की अनुमति नहीं देता जिसे आप प्रबंधित नहीं कर सकते।

यदि आपके पास वर्तमान स्वामी की पहुँच नहीं है, लेकिन आपको लगता है कि आपका संगठन, प्रोजेक्ट या ब्रांड नेमस्पेस का वास्तविक स्वामी है, तो कर्मचारियों की समीक्षा के लिए सार्वजनिक, गैर-संवेदनशील प्रमाण के साथ संगठन / नेमस्पेस दावे की समस्या खोलें। दर्ज करने से पहले संगठन और नेमस्पेस दावे देखें।

यह संगठन नेमस्पेस की सुरक्षा करता है। @openclaw/dronzer नाम वाला पैकेज @openclaw नेमस्पेस पर दावा करता है, इसलिए केवल @openclaw स्वामी तक पहुँच रखने वाले प्रकाशक ही इसे प्रकाशित कर सकते हैं।