समस्या निवारण
clawhub login ब्राउज़र खोलता है, लेकिन कभी पूरा नहीं होता
ब्राउज़र लॉगिन के दौरान CLI एक अल्पकालिक स्थानीय कॉलबैक सर्वर शुरू करता है।
- सुनिश्चित करें कि आपका ब्राउज़र
http://127.0.0.1:<port>/callbackतक पहुँच सकता है। - यदि कॉलबैक कभी नहीं आता, तो स्थानीय फ़ायरवॉल, VPN और प्रॉक्सी नियमों की जाँच करें।
- हेडलेस परिवेशों में, ClawHub वेब UI में API टोकन बनाएँ और चलाएँ:
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: रीसेट का समय।
प्रॉक्सी के पीछे खोज या इंस्टॉल विफल होता है
CLI मानक प्रॉक्सी वेरिएबल का पालन करता है:HTTPS_PROXY, HTTP_PROXY, https_proxy और
http_proxy शामिल हैं।
कोई Skill खोज में दिखाई नहीं देता
- यदि आपको सटीक स्लग या स्वामी पृष्ठ पता है, तो उसकी जाँच करें।
- पुष्टि करें कि रिलीज़ सार्वजनिक है और स्कैन या मॉडरेशन द्वारा रोकी नहीं गई है।
- यदि Skill आपका है, तो साइन इन करके उसका निरीक्षण करें:
आवश्यक मेटाडेटा न होने के कारण प्रकाशन विफल होता है
Skills के लिए,SKILL.md फ्रंटमैटर जाँचें। आवश्यक परिवेश वेरिएबल और
टूल घोषित किए जाने चाहिए, ताकि उपयोगकर्ता और स्कैनर पैकेज को समझ सकें।
Plugins के लिए, package.json संगतता मेटाडेटा जाँचें। कोड-Plugin प्रकाशनों
के लिए openclaw.compat.pluginApi और openclaw.build.openclawVersion जैसे OpenClaw संगतता फ़ील्ड
आवश्यक हैं।
पहले प्रकाशन पेलोड का पूर्वावलोकन करें:
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 हो।
इसे उन रूट पथों पर इंगित करें जिन्हें आप स्कैन करना चाहते हैं:
स्थानीय परिवर्तनों के कारण update मना करता है
स्थानीय फ़ाइलें ClawHub को ज्ञात किसी भी संस्करण से मेल नहीं खातीं। कोई एक विकल्प चुनें:
- स्थानीय संपादन बनाए रखें और अपडेट छोड़ दें।
- प्रकाशित संस्करण से अधिलेखित करें:
- अपनी संपादित प्रति को नए स्लग या फ़ोर्क के रूप में प्रकाशित करें।
OpenClaw में Plugin इंस्टॉल विफल होता है
- स्पष्ट ClawHub स्रोत का उपयोग करें:
- स्कैन स्थिति और संगतता मेटाडेटा के लिए पैकेज विवरण पृष्ठ जाँचें।
- पुष्टि करें कि आपका OpenClaw संस्करण पैकेज की विज्ञापित संगतता सीमा को पूरा करता है।
- यदि पैकेज छिपा हुआ, रोका हुआ या अवरुद्ध है, तो स्वामी द्वारा समस्या का समाधान किए जाने तक संभव है कि उसे इंस्टॉल न किया जा सके।
सार्वजनिक API अनुरोध विफल होते हैं
429पुनः प्रयास हेडर का पालन करें और सार्वजनिक सूची/खोज प्रतिक्रियाओं को कैश करें।- उपयोगकर्ताओं को प्रामाणिक ClawHub सूची पर वापस भेजें।
- छिपी हुई, निजी, रोकी हुई या मॉडरेशन द्वारा अवरुद्ध सामग्री को सार्वजनिक API सतह के बाहर मिरर न करें।