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

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 शामिल हैं।

खोज में कोई स्किल दिखाई नहीं देती

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

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 उपयोग करें।

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

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

यदि आपको लगता है कि आपका org, प्रोजेक्ट, या ब्रांड सही नेमस्पेस मालिक है लेकिन आप मौजूदा ClawHub मालिक को प्रबंधित नहीं कर सकते, तो सार्वजनिक, गैर-संवेदनशील प्रमाण के साथ Org / Namespace Claim issue खोलें। प्रमाण संबंधी मार्गदर्शन और सार्वजनिक मुद्दों से क्या बाहर रखना है, इसके लिए Org और Namespace Claims देखें।

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

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 देखें।