OpenClaw API कॉल में सामान्य त्रुटि कोड और उनके समाधान के लिए गाइड

OpenClaw API को इंटीग्रेट करते समय कई डेवलपर्स को विभिन्न त्रुटियों का सामना करना पड़ता है। यह लेख सबसे सामान्य त्रुटि कोड और उनके समाधान प्रस्तुत करता है, जिससे आप समस्याओं को तुरंत पहचान सकते हैं और नुकसान से बच सकते हैं।

प्रमाणीकरण त्रुटि: 401 Unauthorized

401 त्रुटि का सबसे आम कारण अमान्य या समाप्त API कुंजी है। अपने OpenClaw कंसोल में जांचें कि कुंजी की स्थिति "Active" है, और सुनिश्चित करें कि अनुरोध हेडर में `Authorization` फ़ील्ड का प्रारूप सही है, उदाहरण के लिए `Bearer your_api_key`। यदि कुंजी अभी बनाई गई है, तो कुछ मिनट प्रतीक्षा करें या इसे फिर से कॉपी-पेस्ट करें, अतिरिक्त स्पेस से बचें।

अनुरोध समय समाप्त: 408 Request Timeout

बार-बार अनुरोध टाइमआउट होना आमतौर पर नेटवर्क वातावरण या सर्वर लोड से संबंधित होता है। पहले अपने स्थानीय सिस्टम से OpenClaw API एंडपॉइंट की कनेक्टिविटी जांचें, जैसे `curl` कमांड का उपयोग करके। यदि नेटवर्क सामान्य है, तो एकल अनुरोध के `max_tokens` पैरामीटर मान को कम करने का प्रयास करें, या अधिक समवर्ती कोटा वाले प्लान में अपग्रेड करें। इसके अलावा, पीक घंटों के दौरान बड़ी संख्या में छोटे अनुरोध भेजने से बचें, और एक्सपोनेंशियल बैकऑफ़ रीट्री मैकेनिज्म लागू करें।

पैरामीटर प्रारूप त्रुटि: 400 Bad Request

400 त्रुटि अक्सर अनुरोध बॉडी में गैर-मानक JSON प्रारूप के कारण होती है। उदाहरण के लिए, `model` या `prompt` जैसे आवश्यक फ़ील्ड छूट जाना, या डेटा प्रकार का मेल न खाना (जैसे पूर्णांक को स्ट्रिंग के रूप में लिखना)। JSON वैलिडेशन टूल का उपयोग करके प्रारूप को पहले जांचें, और प्रत्येक फ़ील्ड की अनिवार्यता और मान सीमा के लिए OpenClaw आधिकारिक दस्तावेज़ देखें। सामान्य गलती यह है कि `temperature` पैरामीटर 0-2 की सीमा से बाहर हो जाता है।

संसाधन सीमा: 429 Too Many Requests

429 का मतलब है कि आप दर सीमा को पार कर चुके हैं, आमतौर पर थोड़े समय में अनुरोधों की संख्या कोटा से अधिक होने के कारण। कंसोल में "Usage" पेज देखें और वर्तमान दर सीमा (RPM/TPM) की पुष्टि करें। समाधान दो चरणों में है: पहला, कोड को अनुकूलित करें और कई अनुरोधों को बैच अनुरोधों में मर्ज करें; दूसरा, विशेष रूप से एंटरप्राइज़ उपयोगकर्ताओं के लिए, OpenClaw सहायता से दर सीमा बढ़ाने के लिए संपर्क करें। अस्थायी रूप से अनुरोध आवृत्ति कम करने से भी तेजी से पुनर्स्थापन हो सकता है।