OpenClaw সমস্যা সমাধান — API Key সেটআপ গাইড

🔧 সাধারণ সমস্যা সমাধান

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 সম্পূর্ণভাবে কপি না করার কারণে। প্রতিটি সেবা প্রদানকারী পৃষ্ঠার কনফিগারেশন উদাহরণের সাবধানে তুলনা করুন।