Dépannage

Un problème ? Pas de panique ! Suis les étapes ci-dessous pour diagnostiquer le souci, la plupart se règlent facilement.

🔍 Échelle de diagnostic (suis l'ordre)

Quand OpenClaw rencontre un problème, suis ces étapes dans l'ordre :

Vérifie l'état de fonctionnement

openclaw status

Regarde si OpenClaw est toujours en cours d'exécution. S'il affiche « stopped » ou une erreur, essaie de le redémarrer.

Vérifie l'état de la passerelle

openclaw gateway status

La passerelle est le pont qui connecte OpenClaw aux plateformes de chat. Si elle est en panne, les messages ne peuvent plus être envoyés ni reçus.

Consulte les journaux

openclaw logs

Les journaux enregistrent tous les détails de fonctionnement d'OpenClaw. En cas d'erreur, tu y trouveras généralement un message d'erreur en rouge indiquant la source du problème.

Lance le bilan de santé

openclaw doctor

Vérification complète de la santé du système : elle t'indiquera quels composants fonctionnent et lesquels ont un problème.

Vérifie la connexion des canaux

openclaw channels status

Affiche l'état de connexion de chaque canal de chat, pour voir si l'un d'eux s'est déconnecté.

🐛 Erreurs courantes et solutions

Erreur : « openclaw: command not found »

Cause : Le système ne trouve pas la commande openclaw, c'est généralement un problème de variable d'environnement PATH.

Solution :

# Vérifie où openclaw est installé
npm list -g openclaw

# Ajoute le répertoire global npm au PATH
export PATH="$(npm config get prefix)/bin:$PATH"

# Ajoute cette ligne à ton fichier de configuration shell pour que ce soit permanent
echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Erreur : Conflit de port (EADDRINUSE: address already in use :::18789)

Cause : Le port 18789 est déjà utilisé par un autre programme.

Solution :

# Trouve le processus qui occupe le port
lsof -i :18789

# Arrête l'ancien processus OpenClaw
openclaw stop

# Si ce n'est pas un processus OpenClaw, tu peux changer le port dans la config
# Modifie ~/.openclaw/openclaw.json et change la valeur de port

Erreur : 429 Too Many Requests (limitation de débit)

Cause : Tu envoies des requêtes trop fréquemment. Le fournisseur du modèle IA impose une limite sur les appels API.

Solution :

Attends quelques minutes avant de réessayer
Réduis la fréquence d'envoi de messages
Passe à un plan API payant supérieur pour obtenir une limite plus élevée
Envisage de changer pour un fournisseur de modèle avec des limites plus souples

Erreur : La passerelle ne démarre pas

Cause : Le Bot Token est peut-être invalide, problème de connexion réseau, ou changement de l'API de la plateforme de chat.

Solution :

# Vérifie les journaux de la passerelle
openclaw gateway logs

# Vérifie si le Bot Token est valide
openclaw channels verify

# Redémarre la passerelle
openclaw gateway restart

Erreur : Les messages ne s'envoient pas

Cause : Configuration de canal incorrecte, problème réseau, ou permissions insuffisantes du Bot.

Solution :

Vérifie l'état des canaux : openclaw channels status
Confirme que le Bot a bien la permission d'envoyer des messages sur la plateforme concernée
Vérifie que ta connexion réseau fonctionne
Consulte les journaux pour y trouver un message d'erreur précis

Erreur : Le tableau de bord ne s'ouvre pas

Cause : Le service OpenClaw n'est peut-être pas en cours d'exécution, ou la configuration du port est incorrecte.

Solution :

# Vérifie qu'OpenClaw est en cours d'exécution
openclaw status

# S'il ne tourne pas, démarre-le
openclaw start

# Puis essaie d'ouvrir le tableau de bord
openclaw dashboard

# Ou accède directement via ton navigateur
# http://127.0.0.1:18789/

🆘 Toujours pas résolu ?

Si les méthodes ci-dessus ne règlent pas ton problème, tu peux :

Chercher ou signaler un problème sur GitHub Issues
Rejoindre la communauté Discord d'OpenClaw pour obtenir de l'aide
Quand tu poses une question, pense à joindre le résultat de openclaw doctor et openclaw logs