Face à une erreur sous OPenClaw, difficile de savoir par où commencer. Qu'il s'agisse d'un échec d'appel API ou d'un timeout, identifier rapidement le problème permet de relancer votre workflow. Cet article rassemble les erreurs les plus courantes d'OPenClaw et leurs correctifs manuels, pour vous éviter des détours inutiles.
Clé API invalide ou expirée
Le code 401 indique généralement une clé incorrecte ou expirée. Connectez-vous d'abord à votre compte OPenClaw, puis vérifiez l'état de votre clé dans la section "API Keys". Si elle est marquée en rouge "Expired", générez directement une nouvelle clé et remplacez l'ancienne valeur dans votre code. Attention à ne pas laisser d'espace en trop lors du copier-coller : c'est une erreur fréquente chez les débutants.
Si la clé est valide mais que vous recevez une erreur 403, il se peut que les permissions n'aient pas été cochées. Assurez-vous que la clé dispose bien des droits d'accès aux modèles nécessaires, par exemple "claw-4" ou "claw-vision". Après avoir enregistré, attendez une minute avant de réessayer : la synchronisation des permissions chez OPenClaw peut parfois prendre du retard.
Limitation de débit (erreur 429)
Envoyer trop de requêtes trop rapidement déclenche une limite de taux (Rate Limit), avec le code 429. La version gratuite d'OPenClaw autorise au maximum 30 requêtes par minute, tandis que la version payante offre entre 60 et 200 requêtes selon le forfait. La solution est simple : ajoutez un délai dans votre code. Par exemple, en Python, utilisez time.sleep(2) pour espacer chaque requête d'au moins 2 secondes. Pour un traitement par lots, pensez à implémenter un algorithme de backoff exponentiel.
Vérifiez aussi si plusieurs scripts tournent simultanément. Le tableau de bord, dans la section "Usage", affiche le débit en temps réel. Si la courbe dépasse la ligne rouge, arrêtez tout et patientez quelques minutes. Laissez le système refroidir avant de relancer, ne forcez pas.
