Lors de l'intégration de l'API OpenClaw, de nombreux développeurs sont confrontés à diverses erreurs. Cet article passe en revue les codes d'erreur les plus courants et leurs solutions pour vous aider à identifier rapidement le problème et éviter les pièges.
Erreur d'authentification : 401 Unauthorized
La cause la plus fréquente d'une erreur 401 est une clé API invalide ou expirée. Vérifiez dans votre console OpenClaw que le statut de la clé est bien « Active », et assurez-vous que le champ Authorization dans l'en-tête de la requête est correctement formaté, par exemple Bearer votre_clé_api. Si la clé vient d'être générée, attendez quelques minutes ou recopiez-la en évitant les espaces superflus.
Délai d'attente dépassé : 408 Request Timeout
Des dépassements de délai fréquents sont souvent liés à l'environnement réseau ou à la charge du serveur. Testez d'abord la connectivité entre votre environnement et le point d'accès API OpenClaw, par exemple avec la commande curl. Si le réseau est normal, essayez de réduire la valeur du paramètre max_tokens par requête, ou passez à un forfait avec un quota de concurrence plus élevé. Évitez également d'envoyer un grand nombre de requêtes courtes pendant les heures de pointe ; il est recommandé d'implémenter un mécanisme de réessai avec backoff exponentiel.
