Risoluzione Problemi

Hai problemi con il tuo ClawBox? Questa guida copre i problemi comuni e le loro soluzioni.

Diagnostica Rapida

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

Problemi Comuni

🔴

ClawBox Non Si Avvia

critical

Sintomi:

  • •Nessuna luce o attività
  • •Il LED di stato rimane spento
  • •Nessuna risposta al pulsante di accensione

Soluzioni:

  1. 1Verifica che l'alimentatore sia collegato saldamente
  2. 2Prova una presa di corrente diversa
  3. 3Controlla se il LED di alimentazione sull'adattatore è acceso
  4. 4Contatta il supporto se il problema persiste
🌐

Nessuna Connessione di Rete

high

Sintomi:

  • •Non riesco ad accedere a clawbox.local
  • •I messaggi non vengono inviati
  • •Lo stato mostra offline

Soluzioni:

  1. 1Controlla la connessione del cavo Ethernet (prova a ricollegarlo)
  2. 2Verifica che il router abbia indirizzi DHCP disponibili
  3. 3Prova a connetterti tramite Wi-Fi invece
  4. 4Controlla se altri dispositivi possono accedere alla rete
🐢

Risposte AI Lente

medium

Sintomi:

  • •Lunghi ritardi prima delle risposte
  • •Timeout su query complesse
  • •Il sistema sembra lento

Soluzioni:

  1. 1Assicurati di avere una ventilazione adeguata (evita spazi chiusi)
  2. 2Controlla se altri processi sono in esecuzione (comando top)
  3. 3Riavvia il servizio AI: openclaw restart
  4. 4Considera l'uso di un modello AI più piccolo per risposte più veloci
💬

Messaggi Non Ricevuti

medium

Sintomi:

  • •Il bot appare online ma non risponde
  • •I messaggi risultano inviati ma nessuna risposta
  • •Funziona su alcune piattaforme ma non su altre

Soluzioni:

  1. 1Verifica che la piattaforma sia correttamente associata (controlla le impostazioni)
  2. 2Riavvia il servizio di messaggistica: openclaw restart messaging
  3. 3Ri-autorizza il bot sulla piattaforma interessata
  4. 4Controlla gli URL webhook nelle impostazioni sviluppatore della piattaforma
🌡️

Surriscaldamento

high

Sintomi:

  • •Ventola che gira alla massima velocità costantemente
  • •Avvisi di throttling termico nei log
  • •Il dispositivo è caldo al tatto

Soluzioni:

  1. 1Sposta in un'area ben ventilata
  2. 2Pulisci la polvere dalle prese d'aria e dalla ventola
  3. 3Riduci la temperatura ambiente
  4. 4Controlla che non ci siano ostruzioni al flusso d'aria intorno al dispositivo

Visualizzare i Log

I log sono essenziali per diagnosticare i problemi. Usa questi comandi per accedere ai diversi tipi di log.

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

Opzioni di Reset

⚠️

Attenzione

Alcune opzioni di reset cancellano i tuoi dati. Esegui sempre un backup delle configurazioni importanti prima.

Tipi di Reset

openclaw reset --softRiavvia i servizi senza perdere i dati
openclaw reset --hardSvuota la cache e riavvia tutti i servizi
openclaw reset --factoryCancella tutti i dati e ripristina le impostazioni di fabbrica
# 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

Indicatori LED di Stato

Verde Fisso

Il sistema funziona normalmente

Verde Lampeggiante

Elaborazione di una richiesta o avvio in corso

Arancione Fisso

Il sistema si sta avviando o aggiornando

Arancione Lampeggiante

Stato di avviso — controlla i log per i dettagli

Rosso Fisso

Stato di errore — intervento richiesto

Ottenere Supporto

Se non riesci a risolvere il problema, il nostro team di supporto è pronto ad aiutarti.

Prima di Contattare il Supporto:

  • □Annota il messaggio di errore esatto o il comportamento
  • □Controlla l'indicatore LED di stato
  • □Prova i passaggi di risoluzione problemi pertinenti sopra
  • □Esporta i log: openclaw logs --export

Includi nella Tua Richiesta:

  • ✓Numero di serie ClawBox (sull'etichetta inferiore)
  • ✓Descrizione del problema
  • ✓Passaggi per riprodurre
  • ✓File di esportazione log (se disponibile)
🤖Supporto Telegram💬Community Discord✉️Supporto Email