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

clawhub login ब्राउज़र खोलता है, लेकिन कभी पूरा नहीं होता

ब्राउज़र लॉगिन के दौरान CLI एक अल्पकालिक स्थानीय कॉलबैक सर्वर शुरू करता है।

• सुनिश्चित करें कि आपका ब्राउज़र http://127.0.0.1:<port>/callback तक पहुँच सकता है।
• यदि कॉलबैक कभी नहीं आता, तो स्थानीय फ़ायरवॉल, VPN और प्रॉक्सी नियमों की जाँच करें।
• हेडलेस परिवेशों में, ClawHub वेब UI में API टोकन बनाएँ और चलाएँ:

clawhub login --token clh_...

whoami या publish, Unauthorized (401) लौटाता है

• clawhub login से फिर से साइन इन करें।
• यदि आप कस्टम कॉन्फ़िग पथ का उपयोग करते हैं, तो पुष्टि करें कि CLAWHUB_CONFIG_PATH उस फ़ाइल को इंगित करता है जिसमें आपका वर्तमान टोकन है।
• यदि आप API टोकन का उपयोग करते हैं, तो पुष्टि करें कि उसे वेब UI में निरस्त नहीं किया गया था।

खोज या इंस्टॉल करने पर Rate limit exceeded (429) लौटता है

प्रतिक्रिया में पुनः प्रयास की जानकारी पढ़ें:

• Retry-After: पुनः प्रयास करने से पहले प्रतीक्षा के सेकंड।
• RateLimit-Limit: इस अनुरोध पर लागू सीमा।
• RateLimit-Remaining: हेडर मौजूद होने पर आपका सटीक शेष बजट। 429 पर, यह 0 है।
• RateLimit-Reset या X-RateLimit-Reset: रीसेट का समय।

यदि कई उपयोगकर्ता एक निकास IP साझा करते हैं, तो प्रत्येक व्यक्ति के केवल कुछ अनुरोध भेजने पर भी अनाम IP सीमाएँ पूरी हो सकती हैं। जहाँ संभव हो, साइन इन करें और बताई गई देरी के बाद पुनः प्रयास करें।

प्रॉक्सी के पीछे खोज या इंस्टॉल विफल होता है

CLI मानक प्रॉक्सी वेरिएबल का पालन करता है:

export HTTPS_PROXY=http://proxy.example.com:3128clawhub search "my query"

समर्थित नामों में HTTPS_PROXY, HTTP_PROXY, https_proxy और http_proxy शामिल हैं।

कोई Skill खोज में दिखाई नहीं देता

• यदि आपको सटीक स्लग या स्वामी पृष्ठ पता है, तो उसकी जाँच करें।
• पुष्टि करें कि रिलीज़ सार्वजनिक है और स्कैन या मॉडरेशन द्वारा रोकी नहीं गई है।
• यदि Skill आपका है, तो साइन इन करके उसका निरीक्षण करें:

clawhub inspect @openclaw/demo

स्वामी को दिखाई देने वाला निदान स्कैन, अपलोड-गेट या मॉडरेशन स्थिति की व्याख्या कर सकता है।

आवश्यक मेटाडेटा न होने के कारण प्रकाशन विफल होता है

Skills के लिए, SKILL.md फ्रंटमैटर जाँचें। आवश्यक परिवेश वेरिएबल और टूल घोषित किए जाने चाहिए, ताकि उपयोगकर्ता और स्कैनर पैकेज को समझ सकें।

Plugins के लिए, package.json संगतता मेटाडेटा जाँचें। कोड-Plugin प्रकाशनों के लिए openclaw.compat.pluginApi और openclaw.build.openclawVersion जैसे OpenClaw संगतता फ़ील्ड आवश्यक हैं।

पहले प्रकाशन पेलोड का पूर्वावलोकन करें:

clawhub package publish <source> --family code-plugin --dry-run

GitHub स्वामी या स्रोत त्रुटि के कारण प्रकाशन विफल होता है

ClawHub पैकेजों को उनके प्रकाशकों से जोड़ने के लिए GitHub पहचान और स्रोत एट्रिब्यूशन का उपयोग करता है।

• सुनिश्चित करें कि आपने उस GitHub खाते से साइन इन किया है जो पैकेज का स्वामी है या उसे प्रकाशित कर सकता है।
• जाँचें कि स्रोत URL सार्वजनिक है या ClawHub के लिए सुलभ है।
• GitHub स्रोतों के लिए, owner/repo, owner/repo@ref या पूर्ण GitHub URL का उपयोग करें।

नेमस्पेस पर दावा या उसके आरक्षित होने के कारण प्रकाशन विफल होता है

यदि स्वामी हैंडल, संगठन नेमस्पेस, पैकेज स्कोप, Skill स्लग या पैकेज नाम पर पहले से दावा किए जाने या उसके आरक्षित होने के कारण प्रकाशन विफल होता है, तो पहले पुष्टि करें कि आप नेमस्पेस से मेल खाने वाले स्वामी के साथ प्रकाशित कर रहे हैं। Plugin पैकेजों के लिए, @example-org/example-plugin जैसे स्कोप वाले नामों को मेल खाने वाले example-org स्वामी के रूप में प्रकाशित करना आवश्यक है।

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

sync कहता है कि कोई Skill नहीं मिला

sync उन फ़ोल्डरों को खोजता है जिनमें SKILL.md या skill.md हो।

इसे उन रूट पथों पर इंगित करें जिन्हें आप स्कैन करना चाहते हैं:

clawhub sync --root /path/to/skills

यदि आप सुनिश्चित नहीं हैं कि क्या प्रकाशित होगा, तो पहले पूर्वावलोकन करें:

clawhub sync --all --dry-run --no-input

स्थानीय परिवर्तनों के कारण update मना करता है

स्थानीय फ़ाइलें ClawHub को ज्ञात किसी भी संस्करण से मेल नहीं खातीं। कोई एक विकल्प चुनें:

• स्थानीय संपादन बनाए रखें और अपडेट छोड़ दें।
• प्रकाशित संस्करण से अधिलेखित करें:

clawhub update @openclaw/demo --force

• अपनी संपादित प्रति को नए स्लग या फ़ोर्क के रूप में प्रकाशित करें।

OpenClaw में Plugin इंस्टॉल विफल होता है

• स्पष्ट ClawHub स्रोत का उपयोग करें:

openclaw plugins install clawhub:<package>

• स्कैन स्थिति और संगतता मेटाडेटा के लिए पैकेज विवरण पृष्ठ जाँचें।
• पुष्टि करें कि आपका OpenClaw संस्करण पैकेज की विज्ञापित संगतता सीमा को पूरा करता है।
• यदि पैकेज छिपा हुआ, रोका हुआ या अवरुद्ध है, तो स्वामी द्वारा समस्या का समाधान किए जाने तक संभव है कि उसे इंस्टॉल न किया जा सके।

सार्वजनिक API अनुरोध विफल होते हैं

• 429 पुनः प्रयास हेडर का पालन करें और सार्वजनिक सूची/खोज प्रतिक्रियाओं को कैश करें।
• उपयोगकर्ताओं को प्रामाणिक ClawHub सूची पर वापस भेजें।
• छिपी हुई, निजी, रोकी हुई या मॉडरेशन द्वारा अवरुद्ध सामग्री को सार्वजनिक API सतह के बाहर मिरर न करें।

एंडपॉइंट विवरण के लिए HTTP API देखें।