Lorsque vous développez avec OPenClaw pour l'IA, il est inévitable de se heurter à diverses erreurs. Qu'il s'agisse d'un échec d'appel API ou d'un problème de droits de compte, cet article rassemble plusieurs codes d'erreur fréquents et les pistes de résolution correspondantes, pour vous éviter de perdre du temps.
Erreurs d'authentification API : 401 et 403
Un 401 Unauthorized signifie généralement que votre clé API est invalide ou a expiré. Vérifiez d'abord que la clé n'a pas de caractère manquant, puis rendez-vous dans la section « API Keys » de la console OPenClaw pour en générer une nouvelle. Attention à ne pas oublier les espaces avant et après lors de la copie. Un 403 Forbidden indique généralement que la clé n'a pas les droits pour accéder à une certaine interface. Connectez-vous au panneau d'administration pour vérifier les paramètres de rôle et confirmer que le bon Scope a été attribué à votre compte.
Timeouts et problèmes réseau : 408 et 429
Le code 408 Request Timeout signifie que le serveur a attendu trop longtemps votre requête, souvent dû à une latence réseau élevée ou à une requête trop volumineuse. Essayez de limiter chaque requête à moins de 2 Mo et vérifiez la stabilité de votre proxy réseau. Le code 429 Too Many Requests signale un dépassement de la limite de débit. OPenClaw impose un nombre maximal de requêtes par minute par compte. Attendez 60 secondes avant de réessayer, ou passez à un forfait supérieur pour augmenter le quota et éviter les interrogations trop fréquentes.
Erreurs serveur : 500 et 502
Une 500 Internal Server Error est une panne temporaire côté serveur. L'équipe OPenClaw la résout généralement en quelques minutes. Consultez d'abord l'état du service sur status.openclaw.com, puis réessayez si tout est normal. Si l'erreur persiste, contactez le support technique en fournissant les logs complets de votre requête. Le code 502 Bad Gateway est souvent lié à une passerelle réseau. Attendez 5 minutes puis réessayez – cela suffit généralement à rétablir la situation. Évitez de rafraîchir la page plusieurs fois.
Verrouillage de compte et restrictions d'abonnement
Si après connexion vous voyez Account Locked, c'est probablement dû à plusieurs saisies incorrectes du mot de passe ou à une connexion suspecte. Réinitialisez votre mot de passe via l'e-mail lié et vérifiez l'historique des connexions récentes. Par ailleurs, certaines fonctionnalités avancées nécessitent un abonnement spécifique. Si vous recevez une 400 Bad Request avec le message « insufficient plan », cela signifie que votre forfait ne prend pas en charge cette action. Passez à la version Pro.
Conseils pratiques pour éviter les erreurs
Prenez l'habitude de tester à petite échelle chaque modification de code ou de configuration avant de lancer une tâche complète. Cela vous évitera de nombreuses erreurs. Maintenez également votre SDK OPenClaw à jour : une version obsolète peut provoquer des bugs étranges suite à des changements d'interface. Si vous rencontrez une erreur que vous ne comprenez pas, consultez directement la page d'explication des codes d'erreur dans la documentation officielle : c'est là que vous trouverez les explications les plus précises.
