OPenClaw का उपयोग करते समय API कॉल विफल हो रही है या कनेक्शन टाइमआउट हो रहा है? यह लेख कुछ सामान्य त्रुटियों की पहचान और व्यावहारिक समाधान प्रस्तुत करता है, जिससे आप अपने वर्कफ़्लो को जल्दी से बहाल कर सकते हैं और एरर मैसेज से परेशान नहीं होंगे।
API 401 अनधिकृत त्रुटि: कुंजी और अनुमतियाँ जाँचें
401 एरर आमतौर पर मतलब है कि अनुरोध में वैध क्रेडेंशियल्स गायब हैं। पहले सुनिश्चित करें कि आपकी API कुंजी एनवायरनमेंट वेरिएबल या कॉन्फ़िगरेशन फ़ाइल में सही ढंग से चिपकाई गई है — ध्यान दें कि आगे-पीछे कोई अतिरिक्त स्पेस या न्यू लाइन न हो। यदि कुंजी कंसोल से कॉपी करके सीधे पेस्ट की गई है, तो मैन्युअल रूप से इसे दोबारा टाइप करने की सलाह दी जाती है — कई समस्याएँ कॉपी करते समय कैरेक्टर छूटने से होती हैं। इसके अलावा, कुछ मॉडल या एंडपॉइंट के लिए अतिरिक्त अनुमति स्विच की आवश्यकता होती है; डेवलपर पैनल पर जाकर "एक्सेस की अनुमति" विकल्प को चेक करें।
429 अनुरोध आवृत्ति सीमा: कॉल अंतराल और कोटा समायोजित करें
कम समय में बड़ी संख्या में अनुरोध भेजने से रेट लिमिट ट्रिगर होती है और 429 कोड लौटता है। ऐसे में अंधाधुंध रीट्राई न करें; पहले 5-10 सेकंड रुकें, फिर एक्सपोनेंशियल बैकऑफ़ रणनीति के साथ पुनः प्रयास करें। आप अनुरोध कतार या स्लीप मैकेनिज्म जोड़कर रेट लिमिट से बच सकते हैं। यदि यह बार-बार होता है, तो जाँचें कि क्या आपका खाता ट्रायल मोड में है (ट्रायल कोटा आमतौर पर कम होता है); प्लान अपग्रेड करने या कोटा बढ़ाने से मूल समाधान होगा। साथ ही, पुष्टि करें कि कोई अन्य ऐप एक ही API कुंजी का उपयोग तो नहीं कर रहा है — साझा कुंजी से रेट लिमिट जल्दी टकरा सकती है।
कनेक्शन टाइमआउट या Socket Hang Up: नेटवर्क और प्रॉक्सी की जाँच
"Connection Timeout" या "Socket Hang Up" अक्सर अस्थिर नेटवर्क या गलत प्रॉक्सी कॉन्फ़िगरेशन के कारण होता है। पहले यह जाँचें कि क्या आप सीधे OPenClaw के आधिकारिक सर्वर से कनेक्ट कर सकते हैं — ping या curl कमांड से लेटेंसी टेस्ट करें। यदि प्रॉक्सी का उपयोग कर रहे हैं, तो सुनिश्चित करें कि प्रोटोकॉल और पोर्ट सही हैं, और प्रॉक्सी ट्रैफ़िक को ब्लॉक नहीं कर रहा है। कुछ एंटरप्राइज़ नेटवर्क गैर-मानक पोर्ट को ब्लॉक कर देते हैं; HTTPS पोर्ट (443) का उपयोग करने से कुछ प्रतिबंधों को बायपास किया जा सकता है। इसके अतिरिक्त, बहुत छोटा टाइमआउट भी गलत एरर दे सकता है — डिफ़ॉल्ट 10 सेकंड के बजाय टाइमआउट पैरामीटर को 30 सेकंड तक बढ़ाकर देखें।
500 Internal Server Error: पहले रिक्वेस्ट बॉडी फ़ॉर्मैट जाँचें
जब सर्वर 500 एरर लौटाता है, तो पहले यह न मानें कि सर्वर डाउन है — ज्यादातर मामलों में आपके अनुरोध का फ़ॉर्मैट गलत होता है। जाँचें कि JSON वैध है या नहीं, और फ़ील्ड नाम सही ढंग से लिखे गए हैं (जैसे "model" के बजाय "module" न लिखा हो)। विशेष ध्यान दें कि बूलियन और संख्याएँ कोट्स में न हों — उदाहरण के लिए "temperature": true सीधे क्रैश करेगा। यदि रिक्वेस्ट बॉडी बड़ी है, तो उसे छोटे भागों में भेजने का प्रयास करें, या मैसेज ऐरे में उन भूमिकाओं की जाँच करें जो मॉडल सपोर्ट नहीं करता (जैसे गलती से function रोल का उपयोग करना जबकि मॉडल इसे सपोर्ट नहीं करता)।
403 अनुमति अस्वीकृत: खाता स्थिति और भौगोलिक प्रतिबंध
403 एरर खाता लॉक होने या क्षेत्रीय प्रतिबंध के कारण हो सकता है। पहले OPenClaw की आधिकारिक वेबसाइट पर लॉग इन करके खाते की स्थिति जाँचें — देखें कि कोई बकाया राशि या नियम उल्लंघन का नोटिफिकेशन तो नहीं है। कुछ मॉडल केवल विशिष्ट क्षेत्रों के लिए उपलब्ध होते हैं; यदि आप गैर-समर्थित क्षेत्र के IP का उपयोग कर रहे हैं, तो नोड बदलें या ग्लोबल मोड में प्रयास करें। इसके अलावा, कुछ फ्री ट्रायल खातों की एक्सेस अनुमति समय के साथ कम हो सकती है; नवीनीकरण या पेड प्लान में अपग्रेड करने से आमतौर पर 403 समस्या हल हो जाती है।
