FAQ OPenClaw : Guide de résolution des problèmes de liaison de compte et d'erreurs d'appel API

Lors de l'utilisation d'OPenClaw, de nombreux utilisateurs rencontrent des problèmes tels que l'échec de la liaison de compte, des délais d'attente de requête API ou des erreurs d'interface. Cet article rassemble les scénarios de panne fréquents et leurs méthodes de traitement correspondantes pour vous aider à retrouver rapidement un usage normal et éviter de répéter les mêmes erreurs.

1. Que faire en cas d'échec d'inscription ou de liaison de compte ?

Si vous ne recevez pas l'e-mail de vérification lors de l'inscription, vérifiez d'abord le dossier spam. Si rien ne se passe, essayez de réessayer avec une adresse Gmail ou Outlook. Si la liaison avec une plateforme tierce (comme GitHub, Google) affiche un message d'erreur "Échec d'autorisation", cela est généralement dû au cache du navigateur ou à des droits d'accès non ouverts sur le compte tiers. Il est conseillé de vider les cookies et d'utiliser le mode de navigation privée pour recommencer.

Si après la liaison, un message "Compte restreint" apparaît, cela peut être dû à des tentatives de liaison multiples en peu de temps ayant déclenché une sécurité de risque. Dans ce cas, attendez 24 heures et soumettez un ticket via l'e-mail officiel en expliquant la situation. Le déblocage intervient généralement sous un jour ouvré.

2. Erreurs fréquentes lors de l'appel de clé API

Lorsque la requête renvoie "401 Unauthorized", il est probable que la clé API ait été copiée incomplète ou qu'elle soit expirée. Connectez-vous à la console OPenClaw pour générer une nouvelle clé, et assurez-vous qu'il n'y a pas d'espaces superflus dans votre code. Si le retour est "429 Too Many Requests", cela indique que la fréquence d'appel dépasse la limite du niveau gratuit. Réduisez l'intervalle entre les requêtes ou passez à un forfait supérieur.

Certains utilisateurs signalent une erreur "500 Internal Server Error" de l'interface. Cela est souvent dû à une fluctuation temporaire du serveur ; attendez 5 minutes avant de réessayer. Si l'erreur persiste, essayez de basculer vers un nœud de secours (comme le nom de domaine api.openclaw.net) et vérifiez que votre réseau local ne bloque pas les IP étrangères.

3. Réponses anormales du modèle ou coupure du contenu

Lorsque la réponse de l'IA devient soudainement courte ou répète la même phrase, vérifiez d'abord si le paramètre max_tokens dans votre requête est trop bas (il est recommandé de ne pas descendre en dessous de 512). Si la sortie contient des caractères illisibles ou un mélange de langues, cela peut être dû à la présence de caractères non valides dans le prompt, comme des virgules pleine largeur ou des symboles spéciaux. Remplacez-les par des caractères demi-largeur pour rétablir le fonctionnement.

Si le contenu reste vide pendant longtemps, consultez la section "Statistiques d'utilisation" de la console pour vérifier si le quota gratuit quotidien a été épuisé. Les comptes gratuits sont limités à 500 appels par jour. Au-delà, il faut attendre le lendemain pour que le quota soit réinitialisé, ou souscrire à la version Pro pour débloquer des requêtes illimitées.

4. Synchronisation multi-plateforme et perte de données

Si l'historique des conversations n'est pas synchronisé après un changement d'appareil, assurez-vous de vous être déconnecté correctement sur l'ancien appareil, puis connectez-vous avec le même compte sur le nouveau. Si vous avez vidé manuellement le cache du navigateur, les brouillons de conversation enregistrés localement seront supprimés. Il est conseillé d'exporter régulièrement les conversations importantes sous forme de fichier JSON pour les sauvegarder.

Certains utilisateurs signalent que les membres d'un groupe familial ne peuvent pas voir les projets des autres. Vérifiez que le créateur du groupe familial a bien activé l'autorisation "Partager la conversation". Dans "Paramètres - Gestion des autorisations", cochez le membre concerné pour résoudre le problème.