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

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 पूरी तरह कॉपी न होने के कारण हैं। प्रत्येक सेवा प्रदाता पृष्ठ के कॉन्फ़िगरेशन उदाहरण की सावधानी से तुलना करें।