OPenClaw, en tant que passerelle IA open source, peut causer des erreurs HTTP qui déroutent les débutants. Cet article met l'accent sur les codes d'erreur 403 et 429, deux problèmes courants, pour vous aider à localiser rapidement le problème et reprendre vos appels.
403 Interdit : permissions de clé et restrictions IP
Lorsque vous recevez une erreur 403, commencez par vérifier si votre clé API a expiré ou n'est pas activée. Dans la console OPenClaw, vous pouvez régénérer une clé ; n'oubliez pas de la copier et de la mettre à jour immédiatement dans votre fichier de configuration. Par ailleurs, certains fournisseurs de modèles imposent une liste blanche d'adresses IP sources. Si votre VPS ou votre IP de proxy ne figure pas dans cette liste, l'erreur 403 apparaîtra aussi. Rendez-vous dans le panneau d'administration, cherchez le paramètre « Adresses IP autorisées » et ajoutez votre IP de sortie actuelle pour débloquer l'accès. Une autre cause possible : si vous continuez à envoyer des requêtes après avoir épuisé votre quota gratuit, votre compte est temporairement restreint. Dans ce cas, vous devez recharger votre crédit ou passer à un forfait payant.
429 Trop de requêtes : limites de débit et stratégie de réessai
Le code 429 indique que vous avez envoyé trop de requêtes en peu de temps, dépassant le seuil de débit défini par OPenClaw. La solution immédiate est simple : arrêtez d'envoyer des requêtes, attendez quelques dizaines de secondes, puis réessayez. Pour une approche plus robuste, implémentez une logique de réessai avec backoff exponentiel dans votre code, par exemple en attendant 2, 4, puis 8 secondes après chaque échec. Vérifiez également votre plan d'appel API : les différents forfaits OPenClaw ont des limites différentes en requêtes par minute (RPM). Passer à un forfait supérieur vous donnera un quota plus élevé. Si vous utilisez une clé partagée, évitez d'exécuter un grand nombre de requêtes simultanément avec d'autres utilisateurs ; il est préférable de demander une clé API dédiée.
Autres codes d'erreur courants : 500 et 502
Il arrive parfois de rencontrer une erreur 500 (erreur interne du serveur) ou 502 (délai de passerelle). Ces erreurs sont généralement dues au backend d'OPenClaw ou à un problème chez le fournisseur en amont. Attendez 5 minutes et réessayez. Si le problème persiste, signalez-le sur le GitHub Issues officiel ou sur le serveur Discord. Consultez également la page de statut (status.openclaw.com) pour voir s'il y a une interruption de service annoncée. Lors des tests en local, activez les logs détaillés : cela vous aidera à déterminer rapidement si le problème vient de la configuration ou du serveur. Prenez l'habitude de mettre à jour régulièrement l'image OPenClaw ; les anciennes versions contiennent des bugs connus qui peuvent également déclencher ces erreurs.
