Déboguez et corrigez les problèmes courants de l'assistant IA Clawdbot. Apprenez à diagnostiquer les problèmes de connexion, les échecs de messages et les erreurs de passerelle.

Aperçu du Dépannage Clawdbot

Ce guide vous aide à diagnostiquer et corriger les problèmes courants avec votre déploiement Clawdbot. Trouvez des solutions aux problèmes de connexion, échecs de messages et erreurs de passerelle.

Problèmes Courants

La Passerelle Ne Démarre Pas

Symptômes : La passerelle ne démarre pas ou se ferme immédiatement.

Solutions :

Vérifier la disponibilité du port :

lsof -i :3010

Valider la configuration :

clawdbot config validate

Vérifier les logs :

clawdbot gateway logs

Échec de Connexion WhatsApp

Symptômes : Le code QR ne s'affiche pas ou la connexion est interrompue.

Solutions :

Effacer la session WhatsApp :

rm -rf ~/.clawdbot/providers/whatsapp/session

Redémarrer la passerelle :

clawdbot gateway restart

Vérifier la connectivité réseau

Messages Non Livrés

Symptômes : Messages envoyés mais non reçus.

Solutions :

Vérifier l'état de la session :

clawdbot sessions list

Vérifier la connexion du fournisseur :

clawdbot providers status

Vérifier les limites de débit

L'Agent Ne Répond Pas

Symptômes : L'agent ne génère pas de réponses.

Solutions :

Vérifier l'état de l'agent :

clawdbot agents status

Vérifier la clé API :

echo $ANTHROPIC_API_KEY

Vérifier la disponibilité du modèle

Commandes de Diagnostic

État de la Passerelle

# Vérifier la santé de la passerelle
clawdbot gateway status

# Voir les connexions actives
clawdbot gateway connections

# Afficher l'utilisation des ressources
clawdbot gateway stats

Diagnostic des Sessions

# Lister toutes les sessions
clawdbot sessions list

# Voir les détails de la session
clawdbot sessions get <session-key>

# Effacer une session bloquée
clawdbot sessions clear <session-key>

Diagnostic des Fournisseurs

# Vérifier l'état du fournisseur
clawdbot providers status

# Tester la connexion du fournisseur
clawdbot providers test whatsapp

# Reconnecter le fournisseur
clawdbot providers reconnect telegram

Analyse des Logs

Activer les Logs de Débogage

clawdbot gateway start --log-level debug

Emplacements des Logs

Log	Emplacement
Passerelle	`~/.clawdbot/logs/gateway.log`
Fournisseurs	`~/.clawdbot/logs/providers/`
Agents	`~/.clawdbot/logs/agents/`

Niveaux de Log

Niveau	Description
`error`	Erreurs uniquement
`warn`	Avertissements et erreurs
`info`	Informations générales
`debug`	Informations de débogage détaillées

Codes d'Erreur

Erreurs de Connexion

Code	Description	Solution
`ECONNREFUSED`	Port non ouvert	Vérifier que la passerelle est en cours d'exécution
`ETIMEDOUT`	Délai réseau dépassé	Vérifier le réseau
`EAUTH`	Échec d'authentification	Vérifier les identifiants

Erreurs de Fournisseur

Code	Description	Solution
`WA_DISCONNECTED`	WhatsApp déconnecté	Re-scanner le QR
`TG_INVALID_TOKEN`	Token Telegram invalide	Vérifier le token
`DC_MISSING_INTENTS`	Intents Discord manquants	Activer les intents

Problèmes de Performance

Réponses Lentes

Causes :

Volume élevé de messages
Taille de contexte importante
Latence réseau

Solutions :

Activer le streaming
Réduire la taille du contexte
Vérifier le réseau

Utilisation Mémoire

Vérifier la mémoire :

clawdbot gateway stats --memory

Réduire la mémoire :

{
  "gateway": {
    "messageBuffer": 500,
    "maxHistory": 50
  }
}

Procédures de Récupération

Réinitialiser la Passerelle

# Arrêter la passerelle
clawdbot gateway stop

# Effacer l'état
clawdbot gateway reset --state

# Redémarrer
clawdbot gateway start

Réinitialiser le Fournisseur

# Déconnecter le fournisseur
clawdbot providers disconnect whatsapp

# Effacer les données du fournisseur
rm -rf ~/.clawdbot/providers/whatsapp

# Reconfigurer
clawdbot providers setup whatsapp

Réinitialiser l'Agent

# Effacer les sessions de l'agent
clawdbot agents reset main --sessions

# Effacer l'espace de travail de l'agent
clawdbot agents reset main --workspace

Obtenir de l'Aide

Ressources de Support

Documentation : https://docs.clawdbotai.app
GitHub Issues : https://github.com/clawdbot/clawdbot/issues
Discord Communautaire : https://discord.gg/clawdbot

Rapports de Bugs

Inclure dans les rapports de bugs :

Version de Clawdbot
Système d'exploitation
Messages d'erreur
Étapes de reproduction

Prochaines Étapes

Configuration Clawdbot - Guide de configuration
Sécurité Clawdbot - Configuration de la sécurité
Clawdbot Gateway - Aperçu de la passerelle

Dépannage Clawdbot

On this page