L'utilisation d'OPenClaw peut parfois générer des messages d'erreur. Cet article passe en revue les codes d'erreur les plus courants rencontrés par les utilisateurs, couvrant l'authentification, la connexion réseau et les appels API, et propose des solutions directement applicables pour vous aider à reprendre un usage normal rapidement.
Erreurs de connexion et d'autorisation : 401 et 403
Un message 401 Unauthorized indique généralement que la clé API est invalide ou a expiré. Rendez-vous dans la console OPenClaw pour générer une nouvelle clé et vérifiez qu'elle est correctement saisie dans votre code, sans espaces superflus. Attention, la clé est sensible à la casse.
Le code 403 Forbidden signifie que votre compte ne dispose pas des autorisations nécessaires pour effectuer l'action demandée. Cela survient souvent lorsqu'un utilisateur gratuit tente d'accéder à des fonctionnalités payantes. Vérifiez votre abonnement et, si nécessaire, passez à un forfait supérieur depuis votre compte. Si l'erreur persiste malgré un abonnement actif, contactez le support pour rafraîchir vos droits.
Erreurs réseau et de connexion : Timeout et Connection Reset
Un délai d'attente (Timeout) est souvent dû à une connexion instable ou à une congestion temporaire des serveurs OPenClaw. Essayez d'abord de changer de réseau (par exemple, passez du WiFi aux données mobiles). Si le problème persiste, augmentez le temps d'attente maximal de vos requêtes, par exemple de 30 à 60 secondes.
Une erreur Connection Reset signifie que la connexion a été interrompue brutalement, généralement à cause d'un pare-feu ou d'un proxy bloquant les adresses IP d'OPenClaw. Ajoutez le domaine officiel d'OPenClaw à la liste blanche et désactivez votre VPN ou ajustez les règles de proxy. Pour les utilisateurs en entreprise, vérifiez également les politiques de sécurité réseau qui pourraient limiter les appels API externes.
Erreurs d'appel API : 429 et 500
Le code 429 Too Many Requests est l'erreur de limitation de débit la plus courante. OPenClaw limite la fréquence des appels : 20 requêtes par minute maximum pour les comptes gratuits, avec des quotas plus élevés selon les formules payantes. La solution consiste à réduire la fréquence des requêtes ou à implémenter un mécanisme de backoff exponentiel. Si vos besoins nécessitent un volume élevé, passez à un forfait supérieur pour obtenir un quota plus important.
Un code 500 Internal Server Error signale un dysfonctionnement temporaire du côté d'OPenClaw. Consultez d'abord la page de statut officielle d'OPenClaw pour savoir si une maintenance est en cours. S'il s'agit d'un problème passager, attendez 3 à 5 minutes avant de réessayer. Si l'erreur persiste, envoyez un ticket d'assistance avec les logs complets de vos requêtes pour permettre aux techniciens d'identifier la cause. Évitez de renvoyer les mêmes requêtes en rafale, afin de ne pas déclencher une limitation de débit.
Compte verrouillé ou tentative de connexion suspecte
Plusieurs tentatives de mot de passe incorrectes ou une connexion depuis une région inhabituelle peuvent déclencher le mécanisme de sécurité d'OPenClaw, verrouillant temporairement votre compte. Utilisez le lien de déverrouillage envoyé à votre adresse e-mail d'inscription, ou réinitialisez votre connexion via un code SMS. Si vous ne recevez pas le code, vérifiez vos spams et assurez-vous que votre numéro de téléphone est bien associé à votre compte et non suspendu. Pour les comptes à risque longtemps inactifs, activez la double authentification (2FA) afin de réduire les risques de verrouillage intempestif.
