Das Deinstallieren von OpenClaw ist etwas aufwendiger als nur eine Binärdatei zu löschen. Das Programm installiert einen kontinuierlichen Gateway-Dienst im Hintergrund, erstellt Konfigurations- und Statusverzeichnisse und kann mehrere Instanzen ausführen, wenn Profile verwendet werden. Wenn die Installation über Node-Paketmanager (npm, pnpm, bun) oder als native App erfolgt ist, müssen Dienste, Daten und CLI-Tools entfernt werden.
Der Vorgang kann kompliziert wirken, aber mit dieser Anleitung bleibt nichts auf deinem System zurück.
Welche Komponenten installiert OpenClaw?
Vor der Deinstallation solltest du verstehen, welche Bestandteile vorhanden sein können:
CLI-Tool (openclaw), global installiert über npm/pnpm/bun
Gateway-Dienst, der automatisch abläuft (LaunchAgent, systemd, geplante Aufgabe)
Status- und Konfigurationsverzeichnisse (Standard: ~/.openclaw oder Profilvarianten)
Arbeitsverzeichnisse mit Agent-Dateien
Mögliches macOS-App-Bundle (OpenClaw.app)
Optionale Docker-Container/-Volumes bei Docker-Nutzung
Teilweise Deinstallationen (z. B. nur das Entfernen der CLI) lassen Dienste und Statusdaten bestehen.
Deinstallationspfad wählen
Option A — Empfohlen: CLI ist noch installiert
Wenn der Befehl openclaw noch verfügbar ist, nutze das integrierte Deinstallationskommando:
openclaw uninstall
Das beendet und entfernt den Gateway-Dienst sowie die Statusdaten.
Für eine vollständige Entfernung ohne Rückfragen (z. B. für CI oder Skripte):
openclaw uninstall –all –yes –non-interactive
npx -y openclaw uninstall –all –yes –non-interactive
Diese ist die sauberste Methode, da sie das offiziell unterstützte Kommando nutzt.
Option B — Manuell: CLI fehlt oder Dienst läuft noch
Nutze diesen Weg, wenn:
openclaw nicht mehr funktioniert (z. B. CLI zuerst entfernt)
der Gateway-Dienst weiterhin läuft
du vollständige Kontrolle über alle Komponenten möchtest
Schritt 1: Hintergrunddienst stoppen und entfernen
macOS (LaunchAgent)
Standard-Servicelabel:
ai.openclaw.gateway
Stoppen und entladen:
launchctl bootout gui/$UID/ai.openclaw.gateway
Service-Datei entfernen:
rm -f ~/Library/LaunchAgents/ai.openclaw.gateway.plist
Falls Profile mit –profile verwendet wurden, Label und Dateinamen entsprechend anpassen (z. B. ai.openclaw.<profil>).
Linux (systemd, Benutzer-Dienst)
Standard-Service:
openclaw-gateway.service
Deaktivieren und stoppen:
systemctl –user disable –now openclaw-gateway.service
Service-Datei löschen und neu laden:
rm -f ~/.config/systemd/user/openclaw-gateway.service
systemctl –user daemon-reload
Falls Profil-Services wie openclaw-gateway-<profil>.service existieren, ebenfalls entfernen.
Windows (Scheduled Task)
Standard-Task:
OpenClaw Gateway
Löschen:
schtasks /Delete /F /TN „OpenClaw Gateway“
Zugehöriges Skript entfernen:
Remove-Item -Force „$env:USERPROFILE\.openclaw\gateway.cmd“
Bei Profilen entsprechend anpassen.
Schritt 2: Status- und Konfigurationsverzeichnisse entfernen
Standard-Speicherort:
${OPENCLAW_STATE_DIR:-$HOME/.openclaw}
Löschen:
rm -rf „${OPENCLAW_STATE_DIR:-$HOME/.openclaw}“
Falls ein benutzerdefinierter Konfigurationspfad gesetzt wurde:
rm -f „$OPENCLAW_CONFIG_PATH“
Bei benannten Profilen:
rm -rf ~/.openclaw-*
Für jedes aktive Profil wiederholen.
Schritt 3: CLI-Tool entfernen
Je nach Installationsart:
npm rm -g openclaw
pnpm remove -g openclaw
bun remove -g openclaw
Dadurch werden globale CLI-Binärdateien und zugehörige Dateien entfernt.
Schritt 4: macOS-App entfernen (optional)
Falls das native macOS-Bundle installiert wurde:
rm -rf /Applications/OpenClaw.app
Optional, da das App-Bundle getrennt von CLI und Dienst ist.
Schritt 5: Docker-Bereinigung (optional)
Bei Nutzung von Docker oder Docker Compose:
docker compose down –volumes –remove-orphans
docker rmi openclaw/openclaw:latest
docker volume prune -f
Dadurch werden Container, Images und Volumes entfernt.
Abschließende Überprüfung
1. Wurde das CLI entfernt?
openclaw –version
Sollte „command not found“ zurückgeben.
2. Gibt es noch laufende Dienste?
macOS:
launchctl list | grep -i openclaw
Linux:
systemctl –user status openclaw-gateway.service
Windows:
schtasks /Query /TN „OpenClaw Gateway“
Wenn keine Ergebnisse ausgegeben werden, wurde der Dienst erfolgreich entfernt.
3. Sind noch Restdaten vorhanden?
ls ~/.openclaw ~/.openclaw-*
Sollte „No such file or directory“ melden. Eventuell müssen Restdaten manuell entfernt werden.
Sonderfälle & Best Practices
Profile
Bei Nutzung von –profile oder OPENCLAW_PROFILE wurden separate Verzeichnisse erstellt (~/.openclaw-<profil>). Sie müssen alle entfernen.
Remote-Modus
Bei Nutzung im Remote-Modus befinden sich Gateway und Statusdaten auf dem Server/Host. Die Deinstallation muss dort ebenfalls durchgeführt werden.
Häufige Fehler bei Teil-Deinstallationen
npm uninstall -g openclaw entfernt nur die CLI, nicht Gateway und Statusdaten.
Das Löschen der openclaw-Binärdatei stoppt keine anhaltenden Dienste.
Alte Profilnamen können verwaiste Dienste oder LaunchAgents hinterlassen.
Daher sollten Sie jeden gezeigten Schritt vollständig durchführen.
Vollständige Checkliste
Nachfolgend findest du die vollständige Checkliste für die Deinstallation:
Falls die CLI noch verfügbar ist: openclaw uninstall –all –yes –non-interactive .
Gateway-Dienste stoppen und entfernen (LaunchAgent / systemd / Aufgabenplanung).
Sämtliche Status- und Konfigurationsverzeichnisse löschen.
Globale CLI entfernen (npm, pnpm oder bun).
Optional: macOS-App sowie Docker-Komponenten entfernen.
Überprüfen, dass keine Dienste, Binärdateien oder Daten mehr vorhanden sind.
Damit ist die Deinstallation abgeschlossen. Wenn alle Schritte korrekt durchgeführt wurden, sollte OpenClaw vollständig entfernt sein.
Für weitere Details findest du die vollständige Dokumentation auf der offiziellen OpenClaw-Website.
