OpenClaw Dépannage — Guide de Configuration API Key

🔧 Dépannage courant

Ta clé API est configurée mais ça donne une erreur ? Pas de panique, les problèmes courants sont tous ici.

Erreurs courantes et solutions

❌ 401 Unauthorized / Invalid API Key

Cause :Clé API invalide ou expirée.

Vérifie que ta clé a été copiée en entier (pas d'espaces en plus ni de caractères manquants)
Assure-toi que ta clé n'a pas été désactivée ou supprimée
Confirme que le baseUrl et la clé API correspondent (ne mets pas une clé OpenAI dans une adresse Anthropic)
Pour Coding Plan, utilise la clé Coding Plan avec l'adresse Coding Plan correspondante

❌ 429 Too Many Requests / Rate Limited

Cause :Requêtes trop fréquentes, au-delà des limites de débit.

Attends un moment et réessaie
Si tu es souvent limité, considère un upgrade vers Coding Plan (débit plus élevé)
Ou configure plusieurs fournisseurs pour répartir les requêtes

❌ 402 Payment Required / Insufficient Balance

Cause :Solde insuffisant.

Va recharger sur la plateforme correspondante
Vérifie s'il y a une facture non payée
Vérifie si le crédit gratuit est épuisé

❌ Connection Timeout / Network Error

Cause :Problème de connexion réseau.

Les fournisseurs internationaux (OpenAI, Anthropic, Gemini) peuvent avoir besoin d'un proxy en Chine
Les fournisseurs chinois (DeepSeek, MiniMax, etc.) devraient se connecter directement sans problème
Vérifie que le baseUrl est correct, pas d'erreur de saisie
Essaie curl Commande pour tester la connectivité

❌ 400 Bad Request / Invalid Model

Cause :Nom de modèle incorrect, ou ton compte n'a pas l'accès à ce modèle.

Vérifie que le nom du modèle dans la configuration models est correct
Assure-toi que ton compte/plan supporte ce modèle
Consulte la liste des modèles disponibles sur la page du fournisseur

Techniques de débogage

1. Vérifie la configuration actuelle :

cat ~/.openclaw/openclaw.json

2. Teste la connectivité API :

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

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

3. Consulte les logs OpenClaw :

openclaw logs

4. Redémarre la passerelle :

openclaw gateway restart

💡 Tu ne trouves pas la solution ?La plupart des problèmes viennent d'une erreur dans le baseUrl ou d'une copie incomplète de la clé API. Vérifie bien en comparant avec les exemples sur la page de chaque fournisseur.