OpenClaw Pemecahan Masalah — Panduan Setup API Key

🔧 Troubleshooting pertanyaan umum

API Key sudah konfigurasi tapi error? Jangan khawatir, masalah umum semuanya ada di sini.

Error umum dan solusinya

❌ 401 Unauthorized / Invalid API Key

Penyebab:API Key tidak valid atau sudah expired.

Periksa kunci telah dicopy lengkap (tidak ada spasi ekstra atau karakter hilang)
Konfirmkan kunci tidak dinonaktifkan atau dihapus
Pastikan baseUrl dan API Key match (jangan masukkan Key OpenAI ke alamat Anthropic)
Key Coding Plan harus gunakan baseUrl Coding Plan, jangan salah tempat

❌ 429 Too Many Requests / Rate Limited

Penyebab:Request terlalu sering, melebihi rate limit.

Tunggu sebentar lalu coba lagi
Jika sering terbatas, pertimbangkan upgrade ke Coding Plan (rate limit lebih tinggi)
atau konfigurasi multiple provider, distribusikan request

❌ 402 Payment Required / Insufficient Balance

Penyebab:Saldo tidak cukup.

Pergi ke platform yang sesuai isi ulang
Periksa apakah ada tagihan belum dibayar
Periksa apakah tier gratis sudah habis

❌ Connection Timeout / Network Error

Penyebab:Masalah koneksi jaringan.

Penyedia internasional (OpenAI, Anthropic, Gemini) mungkin perlu proxy di China domestik
Penyedia China domestik (DeepSeek, MiniMax dll) seharusnya koneksi langsung tidak masalah
Periksa baseUrl benar, apakah ada typo
Coba curl Coba perintah test koneksi

❌ 400 Bad Request / Invalid Model

Penyebab:Nama model salah, atau akun Anda tidak memiliki akses ke model itu.

Periksa nama model di konfigurasi models sudah benar
Konfirmkan akun/paket mendukung model itu
Lihat daftar model yang tersedia di halaman penyedia masing-masing

Tips debugging

1. Periksa konfigurasi saat ini:

cat ~/.openclaw/openclaw.json

2. Test koneksi API:

# 测试 DeepSeek
curl -s https://api.deepseek.com/v1/models -H "Authorization: Bearer sk-kunci-anda"

# Test OpenAI
curl -s https://api.openai.com/v1/models -H "Authorization: Bearer sk-kunci-anda"

3. Lihat log OpenClaw:

openclaw logs

4. Restart gateway:

openclaw gateway restart

💡 Masih tidak bisa diperbaiki?Mayoritas masalah adalah baseUrl salah atau API Key tidak copy lengkap. Teliti bandingkan dengan contoh konfigurasi di halaman setiap penyedia.