🔧 सामान्य समस्या निवारण
API Key कॉन्फ़िगर किया गया लेकिन त्रुटि? चिंता न करें, सामान्य समस्याएँ यहाँ हैं।
सामान्य त्रुटियाँ और समाधान
❌ 401 Unauthorized / Invalid API Key
कारण:API Key अमान्य या समाप्त हो गई।
- जाँचें कि कुंजी पूरी तरह कॉपी की गई है (अतिरिक्त स्थान या लुप्त वर्ण नहीं)
- सुनिश्चित करें कि कुंजी अक्षम या हटाई नहीं गई है
- सुनिश्चित करें कि baseUrl और API Key मेल खाते हैं (OpenAI की Key को Anthropic पते पर न डालें)
- Coding Plan की Key को Coding Plan के baseUrl का उपयोग करना चाहिए, भ्रमित न करें
❌ 429 Too Many Requests / Rate Limited
कारण:अनुरोध बहुत बार, गति सीमा अधिक हो गई है।
- थोड़ी देर प्रतीक्षा करें फिर से कोशिश करें
- यदि अक्सर गति सीमित होते हैं, तो Coding Plan में अपग्रेड करने पर विचार करें (गति अधिक)
- या कई provider को कॉन्फ़िगर करें, अनुरोधों को विभाजित करें
❌ 402 Payment Required / Insufficient Balance
कारण:शेष राशि अपर्याप्त है।
- संबंधित प्लेटफॉर्म पर जमा करें
- जाँचें कि क्या कोई अभी तक भुगतान न किया गया बिल है
- मुफ़्त क्रेडिट समाप्त हो गई है या नहीं
❌ Connection Timeout / Network Error
कारण:नेटवर्क कनेक्शन समस्या।
- International सेवा प्रदाता (OpenAI, Anthropic, Gemini) को China domestic में VPN की आवश्यकता हो सकती है
- China domestic सेवा प्रदाता (DeepSeek, MiniMax आदि) को सीधी कनेक्टिविटी में कोई समस्या नहीं होनी चाहिए
- जाँचें कि baseUrl सही है, कोई स्पेलिंग त्रुटि नहीं है
- कोशिश करें
curlकमांड कनेक्टिविटी परीक्षण करता है
❌ 400 Bad Request / Invalid Model
कारण:मॉडल नाम गलत लिखा गया है, या आपके खाते के पास इस मॉडल की एक्सेस अनुमति नहीं है।
- जाँचें कि models कॉन्फ़िगरेशन में मॉडल नाम सही है या नहीं
- सुनिश्चित करें कि आपके खाते/योजना में इस मॉडल की सहायता है
- प्रत्येक सेवा प्रदाता पृष्ठ की उपलब्ध मॉडल सूची देखें
डिबग करने की तकनीकें
1. वर्तमान कॉन्फ़िगरेशन जाँचें:
cat ~/.openclaw/openclaw.json
2. API कनेक्टिविटी परीक्षण करें:
# 测试 DeepSeek
curl -s https://api.deepseek.com/v1/models -H "Authorization: Bearer sk-आपकी कुंजी"
# OpenAI परीक्षा
curl -s https://api.openai.com/v1/models -H "Authorization: Bearer sk-आपकी कुंजी"
3. OpenClaw लॉग देखें:
openclaw logs
4. Gateway को फिर से शुरू करें:
openclaw gateway restart
अभी भी हल नहीं हुआ?अधिकांश समस्याएँ baseUrl गलत लिखे जाने या API Key पूरी तरह कॉपी न होने के कारण हैं। प्रत्येक सेवा प्रदाता पृष्ठ के कॉन्फ़िगरेशन उदाहरण की सावधानी से तुलना करें।