Debuggen und beheben Sie häufige Probleme des Clawdbot KI-Assistenten. Erfahren Sie, wie Sie Verbindungsprobleme, Nachrichtenfehler und Gateway-Fehler diagnostizieren.

Übersicht der Clawdbot Fehlerbehebung

Dieser Leitfaden hilft Ihnen, häufige Probleme mit Ihrer Clawdbot-Bereitstellung zu diagnostizieren und zu beheben. Finden Sie Lösungen für Verbindungsprobleme, Nachrichtenfehler und Gateway-Fehler.

Häufige Probleme

Gateway Startet Nicht

Symptome: Gateway startet nicht oder beendet sich sofort.

Lösungen:

Port-Verfügbarkeit prüfen:

lsof -i :3010

Konfiguration validieren:

clawdbot config validate

Logs prüfen:

clawdbot gateway logs

WhatsApp-Verbindung Fehlgeschlagen

Symptome: QR-Code wird nicht angezeigt oder Verbindung bricht ab.

Lösungen:

WhatsApp-Sitzung löschen:

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

Gateway neu starten:

clawdbot gateway restart

Netzwerkverbindung prüfen

Nachrichten Nicht Zugestellt

Symptome: Nachrichten gesendet aber nicht empfangen.

Lösungen:

Sitzungsstatus prüfen:

clawdbot sessions list

Provider-Verbindung überprüfen:

clawdbot providers status

Ratenbegrenzungen prüfen

Agent Antwortet Nicht

Symptome: Agent generiert keine Antworten.

Lösungen:

Agentenstatus prüfen:

clawdbot agents status

API-Schlüssel überprüfen:

echo $ANTHROPIC_API_KEY

Modellverfügbarkeit prüfen

Diagnosebefehle

Gateway-Status

# Gateway-Gesundheit prüfen
clawdbot gateway status

# Aktive Verbindungen anzeigen
clawdbot gateway connections

# Ressourcennutzung anzeigen
clawdbot gateway stats

Sitzungsdiagnose

# Alle Sitzungen auflisten
clawdbot sessions list

# Sitzungsdetails anzeigen
clawdbot sessions get <session-key>

# Hängende Sitzung löschen
clawdbot sessions clear <session-key>

Provider-Diagnose

# Provider-Status prüfen
clawdbot providers status

# Provider-Verbindung testen
clawdbot providers test whatsapp

# Provider neu verbinden
clawdbot providers reconnect telegram

Log-Analyse

Debug-Logging Aktivieren

clawdbot gateway start --log-level debug

Log-Speicherorte

Log	Speicherort
Gateway	`~/.clawdbot/logs/gateway.log`
Provider	`~/.clawdbot/logs/providers/`
Agenten	`~/.clawdbot/logs/agents/`

Log-Stufen

Stufe	Beschreibung
`error`	Nur Fehler
`warn`	Warnungen und Fehler
`info`	Allgemeine Informationen
`debug`	Detaillierte Debug-Informationen

Fehlercodes

Verbindungsfehler

Code	Beschreibung	Lösung
`ECONNREFUSED`	Port nicht offen	Prüfen, ob Gateway läuft
`ETIMEDOUT`	Netzwerk-Timeout	Netzwerk prüfen
`EAUTH`	Authentifizierung fehlgeschlagen	Anmeldedaten überprüfen

Provider-Fehler

Code	Beschreibung	Lösung
`WA_DISCONNECTED`	WhatsApp getrennt	QR erneut scannen
`TG_INVALID_TOKEN`	Ungültiger Telegram-Token	Token prüfen
`DC_MISSING_INTENTS`	Discord-Intents fehlen	Intents aktivieren

Leistungsprobleme

Langsame Antworten

Ursachen:

Hohes Nachrichtenvolumen
Große Kontextgröße
Netzwerklatenz

Lösungen:

Streaming aktivieren
Kontextgröße reduzieren
Netzwerk prüfen

Speicherverbrauch

Speicher prüfen:

clawdbot gateway stats --memory

Speicher reduzieren:

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

Wiederherstellungsverfahren

Gateway Zurücksetzen

# Gateway stoppen
clawdbot gateway stop

# Zustand löschen
clawdbot gateway reset --state

# Neu starten
clawdbot gateway start

Provider Zurücksetzen

# Provider trennen
clawdbot providers disconnect whatsapp

# Provider-Daten löschen
rm -rf ~/.clawdbot/providers/whatsapp

# Neu konfigurieren
clawdbot providers setup whatsapp

Agent Zurücksetzen

# Agenten-Sitzungen löschen
clawdbot agents reset main --sessions

# Agenten-Workspace löschen
clawdbot agents reset main --workspace

Hilfe Erhalten

Support-Ressourcen

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

Fehlerberichte

In Fehlerberichte aufnehmen:

Clawdbot-Version
Betriebssystem
Fehlermeldungen
Schritte zur Reproduktion

Nächste Schritte

Clawdbot Konfiguration - Konfigurationsleitfaden
Clawdbot Sicherheit - Sicherheitseinrichtung
Clawdbot Gateway - Gateway-Übersicht

Clawdbot Fehlerbehebung

On this page