Zum Inhalt springen

OpenClaw Fehler beheben: Logs analysieren und debuggen

Kennst du das? Du hast alles konfiguriert, schickst die erste Nachricht ab und wartest gespannt auf die Antwort – aber es passiert einfach gar nichts. Kein Fehler, kein Timeout, einfach nur Stille. Debugging kann frustrierend sein, wenn man nicht weiß, wo man suchen soll.

Gute Logs sind in solchen Momenten dein bester Freund. Hier erfährst du, wie du Fehler in OpenClaw schnell findest und behebst.

Du findest die Logs unter $OPENCLAW_STATE_DIR/logs (Standardpfad: ~/.openclaw/logs).

Für den schnellen Zugriff kannst du diese Befehle nutzen:

Terminal-Fenster
# Open logs directory
openclaw logs --path
# Tail live
openclaw logs --follow
# Show last 500 lines
openclaw logs

Die Logs werden täglich rotiert. Du kannst sie zudem im JSON-Format ausgeben lassen, falls du sie mit strukturierten Tools parsen möchtest.

Wenn du live sehen willst, was im System passiert, nutzt du den --follow Flag:

Terminal-Fenster
openclaw logs --follow
# Filter JSON logs
openclaw logs --follow --json | jq 'select(.level == "error")'

Eine Nachricht kam an, aber keine Antwort wurde gesendet. Wie debugge ich das?

Abschnitt betitelt „Eine Nachricht kam an, aber keine Antwort wurde gesendet. Wie debugge ich das?“

Wenn das System stumm bleibt, gehst du am besten diese Schritte durch:

  1. Check die Logs:

    Terminal-Fenster
    openclaw logs --follow
  2. Starte den Debug-Modus temporär:

    Terminal-Fenster
    openclaw gateway stop
    OPENCLAW_DEBUG=1 openclaw gateway start
  3. Bestätige, dass der Channel aktiv ist und die Nachricht nicht ignoriert wurde:

    Terminal-Fenster
    openclaw channels status
  4. Prüfe den Status von Session und Model:

    Terminal-Fenster
    openclaw status
    openclaw models status
  5. Suche in den Logs gezielt nach Fehlern zu Rate-Limits, Auth-Problemen oder Model-Fehlern.

Die Logs sind zu unübersichtlich oder nicht detailliert genug. Wie passe ich das an?

Abschnitt betitelt „Die Logs sind zu unübersichtlich oder nicht detailliert genug. Wie passe ich das an?“

Du kannst den Detailgrad über gateway.logLevel steuern (Standard ist info):

  • debug = sehr ausführlich
  • info = normal
  • warn = nur Warnungen und Fehler
  • error = nur kritische Fehler
{
gateway: { logLevel: "debug" }
}

Der Dienst startet nach einem Absturz nicht automatisch neu. Was ist los?

Abschnitt betitelt „Der Dienst startet nach einem Absturz nicht automatisch neu. Was ist los?“

Prüfe die Konfiguration deines Service-Managers (launchd oder systemd):

  • launchd: KeepAlive muss auf true stehen.
  • systemd: Nutze Restart=on-failure und WantedBy=multi-user.target.

So verifizierst du den Status des Dienstes:

Terminal-Fenster
# macOS
launchctl list | grep openclaw
# Linux
systemctl --user status openclaw
journalctl --user -u openclaw -n 100

Du kannst den Health-Status direkt über die API oder das CLI abrufen:

Terminal-Fenster
curl http://localhost:18789/health
# Or via CLI
openclaw health
openclaw health --json

Ich habe versehentlich etwas kaputt gemacht. Wie setze ich alles zurück?

Abschnitt betitelt „Ich habe versehentlich etwas kaputt gemacht. Wie setze ich alles zurück?“

Wenn gar nichts mehr geht, hilft ein Reset. Du kannst entweder alles löschen oder nur die Sessions zurücksetzen:

Terminal-Fenster
# Full reset (wipes config, creds, sessions)
openclaw reset --scope full --yes
# Or just sessions
openclaw reset --scope sessions --yes

Führe danach das Onboarding erneut aus:

Terminal-Fenster
openclaw onboard --install-daemon

Wenn du auf ein Problem stößt, das du nicht selbst lösen kannst, folge diesen Schritten:

  1. Reproduziere den Fehler mit aktivem Debug-Logging:
    Terminal-Fenster
    OPENCLAW_DEBUG=1 openclaw gateway restart
  2. Schau bei den GitHub Issues nach, ob das Problem bereits bekannt ist.
  3. Falls nicht, eröffne ein neues Issue mit diesen Informationen:
    • OpenClaw Version (openclaw --version)
    • Betriebssystem und Node.js Version
    • Relevante Log-Ausschnitte (entferne vorher API-Keys oder Tokens!)
    • Eine kurze Anleitung, wie man den Fehler reproduziert

Hast du weitere Fragen? Nutze den AI Setup Assistant.

OpenClaw

OpenClaw Expert

Noch festgefahren?

Wenn diese Seite nicht hilft, frage OpenClaw Expert nach Schritt-fuer-Schritt-Loesungen.