Dépannage

Vous rencontrez des problèmes avec votre ClawBox ? Ce guide couvre les problèmes courants et leurs solutions.

Diagnostic rapide

Terminal
# SSH into your ClawBox (user: clawbox, password: clawbox)
# Check system status
ssh clawbox@clawbox.local 'openclaw status'

# View recent logs
ssh clawbox@clawbox.local 'openclaw logs --tail 50'

# Check service health
ssh clawbox@clawbox.local 'openclaw health'

# Test network connectivity
ping clawbox.local

Problèmes courants

🔴

ClawBox ne démarre pas

critical

Symptômes :

  • •Aucune lumière ou activité
  • •Le voyant d'état reste éteint
  • •Aucune réponse au bouton d'alimentation

Solutions :

  1. 1Vérifiez que l'adaptateur secteur est bien connecté
  2. 2Essayez une autre prise électrique
  3. 3Vérifiez si le voyant d'alimentation de l'adaptateur est allumé
  4. 4Contactez le support si le problème persiste
🌐

Pas de connexion réseau

high

Symptômes :

  • •Impossible d'accéder à clawbox.local
  • •Messages non envoyés
  • •L'état indique hors ligne

Solutions :

  1. 1Vérifiez la connexion du câble Ethernet (essayez de le rebrancher)
  2. 2Vérifiez que votre routeur a des adresses DHCP disponibles
  3. 3Essayez de vous connecter via Wi-Fi à la place
  4. 4Vérifiez si d'autres appareils peuvent accéder au réseau
🐢

Réponses IA lentes

medium

Symptômes :

  • •Longs délais avant les réponses
  • •Délais d'attente dépassés sur les requêtes complexes
  • •Le système semble lent

Solutions :

  1. 1Assurez une ventilation adéquate (évitez les espaces confinés)
  2. 2Vérifiez si d'autres processus sont en cours (commande top)
  3. 3Redémarrez le service IA : openclaw restart
  4. 4Envisagez d'utiliser un modèle IA plus petit pour des réponses plus rapides
💬

Messages non reçus

medium

Symptômes :

  • •Le bot apparaît en ligne mais ne répond pas
  • •Les messages apparaissent comme envoyés mais pas de réponse
  • •Fonctionne sur certaines plateformes mais pas d'autres

Solutions :

  1. 1Vérifiez que la plateforme est correctement appairée (vérifiez les paramètres)
  2. 2Redémarrez le service de messagerie : openclaw restart messaging
  3. 3Réautorisez le bot sur la plateforme concernée
  4. 4Vérifiez les URL de webhook dans les paramètres développeur de la plateforme
🌡️

Surchauffe

high

Symptômes :

  • •Ventilateur fonctionnant à pleine vitesse en permanence
  • •Avertissements de limitation thermique dans les logs
  • •L'appareil est chaud au toucher

Solutions :

  1. 1Déplacez vers un endroit bien ventilé
  2. 2Nettoyez la poussière des aérations et du ventilateur
  3. 3Réduisez la température ambiante
  4. 4Vérifiez qu'il n'y a pas d'obstruction du flux d'air autour de l'appareil

Consultation des logs

Les logs sont essentiels pour diagnostiquer les problèmes. Utilisez ces commandes pour accéder aux différents types de logs.

Terminal
# View all logs
openclaw logs

# View specific service logs
openclaw logs --service chat
openclaw logs --service browser
openclaw logs --service voice

# Follow logs in real-time
openclaw logs -f

# Filter by log level
openclaw logs --level error

# Export logs for support
openclaw logs --export support-bundle.zip

Options de réinitialisation

⚠️

Avertissement

Certaines options de réinitialisation effaceront vos données. Sauvegardez toujours les configurations importantes au préalable.

Types de réinitialisation

openclaw reset --softRedémarre les services sans perdre de données
openclaw reset --hardEfface le cache et redémarre tous les services
openclaw reset --factoryEfface toutes les données et restaure les paramètres d'usine
# Soft reset (restart services)
openclaw reset --soft

# Hard reset (clear cache, restart)
openclaw reset --hard

# Factory reset (WARNING: erases all data)
openclaw reset --factory --confirm

Indicateurs d'état LED

Vert fixe

Le système fonctionne normalement

Vert clignotant

Traitement d'une requête ou démarrage en cours

Orange fixe

Le système démarre ou se met à jour

Orange clignotant

État d'avertissement — consultez les logs pour plus de détails

Rouge fixe

État d'erreur — intervention requise

Obtenir de l'aide

Si vous ne pouvez pas résoudre le problème, notre équipe de support est prête à vous aider.

Avant de contacter le support :

  • □Notez le message d'erreur exact ou le comportement observé
  • □Vérifiez l'indicateur d'état LED
  • □Essayez les étapes de dépannage correspondantes ci-dessus
  • □Exportez les logs : openclaw logs --export

Incluez dans votre demande :

  • ✓Numéro de série ClawBox (sur l'étiquette en dessous)
  • ✓Description du problème
  • ✓Étapes pour reproduire le problème
  • ✓Fichier d'export des logs (si disponible)
🤖Support Telegram💬Communauté Discord✉️Support par e-mail