Fehlerbehebung

Haben Sie Probleme mit Ihrer ClawBox? Diese Anleitung behandelt häufige Probleme und deren Lösungen.

Schnelldiagnose

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

Häufige Probleme

🔴

ClawBox startet nicht

critical

Symptome:

  • •Keine Lichter oder Aktivität
  • •Status-LED bleibt aus
  • •Keine Reaktion auf Ein-/Ausschalter

Lösungen:

  1. 1Überprüfen Sie, ob das Netzteil fest angeschlossen ist
  2. 2Versuchen Sie eine andere Steckdose
  3. 3Prüfen Sie, ob die LED am Netzteil leuchtet
  4. 4Kontaktieren Sie den Support, wenn das Problem weiterhin besteht
🌐

Keine Netzwerkverbindung

high

Symptome:

  • •Kann nicht auf clawbox.local zugreifen
  • •Nachrichten werden nicht gesendet
  • •Status zeigt offline an

Lösungen:

  1. 1Überprüfen Sie die Ethernet-Kabelverbindung (erneut einstecken)
  2. 2Stellen Sie sicher, dass Ihr Router verfügbare DHCP-Adressen hat
  3. 3Versuchen Sie stattdessen eine WLAN-Verbindung
  4. 4Prüfen Sie, ob andere Geräte auf das Netzwerk zugreifen können
🐢

Langsame KI-Antworten

medium

Symptome:

  • •Lange Verzögerungen vor Antworten
  • •Zeitüberschreitungen bei komplexen Anfragen
  • •System fühlt sich träge an

Lösungen:

  1. 1Sorgen Sie für ausreichende Belüftung (vermeiden Sie geschlossene Räume)
  2. 2Prüfen Sie, ob andere Prozesse laufen (top-Befehl)
  3. 3Starten Sie den KI-Dienst neu: openclaw restart
  4. 4Erwägen Sie ein kleineres KI-Modell für schnellere Antworten
💬

Nachrichten werden nicht empfangen

medium

Symptome:

  • •Bot erscheint online, antwortet aber nicht
  • •Nachrichten werden als gesendet angezeigt, aber keine Antwort
  • •Funktioniert auf einigen Plattformen, aber nicht auf anderen

Lösungen:

  1. 1Überprüfen Sie, ob die Plattform korrekt gekoppelt ist (Einstellungen prüfen)
  2. 2Starten Sie den Messaging-Dienst neu: openclaw restart messaging
  3. 3Autorisieren Sie den Bot erneut auf der betroffenen Plattform
  4. 4Überprüfen Sie die Webhook-URLs in den Plattform-Entwicklereinstellungen
🌡️

Überhitzung

high

Symptome:

  • •Lüfter läuft ständig auf voller Geschwindigkeit
  • •Thermal-Throttling-Warnungen in den Logs
  • •Gerät fühlt sich heiß an

Lösungen:

  1. 1Stellen Sie das Gerät an einen gut belüfteten Ort
  2. 2Reinigen Sie Staub von Lüftungsschlitzen und Lüfter
  3. 3Reduzieren Sie die Umgebungstemperatur
  4. 4Prüfen Sie auf blockierte Luftzirkulation um das Gerät

Logs anzeigen

Logs sind essenziell für die Fehlerdiagnose. Verwenden Sie diese Befehle, um auf verschiedene Log-Typen zuzugreifen.

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

Reset-Optionen

⚠️

Warnung

Einige Reset-Optionen löschen Ihre Daten. Sichern Sie wichtige Konfigurationen immer vorher.

Reset-Typen

openclaw reset --softStartet Dienste neu, ohne Daten zu verlieren
openclaw reset --hardLöscht Cache und startet alle Dienste neu
openclaw reset --factoryLöscht alle Daten und stellt Werkseinstellungen wieder her
# 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

LED-Statusanzeigen

Dauerhaft Grün

System läuft normal

Blinkend Grün

Verarbeitet eine Anfrage oder startet gerade

Dauerhaft Orange

System startet oder aktualisiert sich

Blinkend Orange

Warnungszustand — prüfen Sie die Logs für Details

Dauerhaft Rot

Fehlerzustand — Eingriff erforderlich

Support erhalten

Wenn Sie das Problem nicht lösen können, ist unser Support-Team bereit zu helfen.

Bevor Sie den Support kontaktieren:

  • □Notieren Sie die genaue Fehlermeldung oder das Verhalten
  • □Prüfen Sie die LED-Statusanzeige
  • □Versuchen Sie die entsprechenden Fehlerbehebungsschritte oben
  • □Exportieren Sie Logs: openclaw logs --export

Fügen Sie Ihrer Anfrage bei:

  • ✓ClawBox-Seriennummer (auf dem Etikett unten)
  • ✓Beschreibung des Problems
  • ✓Schritte zur Reproduktion
  • ✓Log-Export-Datei (falls verfügbar)
🤖Telegram Support💬Discord Community✉️E-Mail Support