OpenClaw installiert weit mehr als eine einzelne ausführbare Datei. Der Gateway-Dienst, Launch Agents, Statusverzeichnisse, zwischengespeicherte Anmeldedaten und optionale Desktop-Apps bleiben alle bestehen, bis Sie sie ausdrücklich entfernen. Deshalb erfordert eine saubere Deinstallation mehr als das Löschen des CLI-Binarys.
Diese praktische Schritt-für-Schritt-Anleitung erläutert Backups, den unterstützten Ablauf mit openclaw uninstall, die plattformspezifische Entfernung von Diensten und die Bereinigung übrig gebliebener Dateien, damit keine Profilordner oder API-Geheimnisse zurückbleiben.
TL;DR
Frage | Antwort |
Wie bereite ich die Entfernung vor? | Führen Sie |
Welcher Befehl übernimmt den Großteil der Arbeit? |
|
Was ist mit der Bereinigung übrig gebliebener Dateien? | Löschen Sie |
Brauche ich betriebssystemspezifische Schritte? | Ja: Entfernen Sie |
Wie bestätige ich, dass alles entfernt ist? | Prüfen Sie |
Backup erstellen und jedes Profil erfassen
- Dadurch wird ein wiederherstellbares Archiv von Agent-Workspaces, Cron-Logs und Speicherdateien erstellt. (Quelle: OpenClaw-CLI-Deinstallationsdokumentation)
- Statusverzeichnisse auflisten: Prüfen Sie auf
~/.openclaw,~/.openclaw-<profile>und benutzerdefinierteOPENCLAW_STATE_DIR-Speicherorte. Notieren Sie sie; Sie löschen sie später einzeln. - Konnektoren katalogisieren: Notieren Sie, welche Slack-Workspaces, Google-Konten, benutzerdefinierten Webhooks oder persönlichen API-Schlüssel verknüpft wurden, damit Sie sie nach der Entfernung widerrufen können.
Offiziellen Deinstallationsablauf ausführen
Solange die CLI noch vorhanden ist, lassen Sie OpenClaw seine eigenen Dienste entfernen:
- Dieser Befehl stoppt das Gateway, deregistriert launchd-/systemd-/schtasks-Einträge, löscht das Standard-Statusverzeichnis und entfernt zwischengespeicherte Anmeldedaten.
- Verwenden Sie zunächst
openclaw uninstall --dry-run, wenn Sie eine Vorschau darauf benötigen, was entfernt wird.
Wenn die CLI bereits entfernt wurde, springen Sie zum Abschnitt zur manuellen Dienstentfernung.
Betriebssystemdienste stoppen und deregistrieren
macOS (launchd)
Ersetzen Sie ai.openclaw.gateway für jedes von Ihnen erstellte Profil durch ai.openclaw.<profile>.
Linux (systemd-Benutzereinheit)
Ältere Units verwenden openclaw-gateway-<profile>.service; entfernen Sie jede davon, bevor Sie fortfahren.
Windows (Geplante Aufgabe)
Öffnen Sie PowerShell mit demselben Benutzerkonto, das OpenClaw installiert hat:
Löschen Sie anschließend %USERPROFILE%\.openclaw\gateway.cmd (oder die profilbezogene Variante), damit Windows es nicht erneut starten kann.
Übrig gebliebene Dateien und Profile löschen
Hier kommt das sekundäre Keyword OpenClaw-Bereinigung übrig gebliebener Dateien ins Spiel.
- Profilspezifische Verzeichnisse: für jedes Profil, das Sie zuvor notiert haben:
- Benutzerdefinierter Konfigurationspfad: Wenn Sie
OPENCLAW_CONFIG_PATHgesetzt haben, löschen Sie auch diese Datei. - Docker- oder VM-Sandboxes: Führen Sie
docker rm/docker rmi(oderpodman rm/podman rmi) für alle Images aus, die mit OpenClaw getaggt sind, um Registries sauber zu halten.
Die CLI + Desktop-Apps entfernen
Je nach verwendetem Installer:
Wenn Sie install.sh / install.ps1 verwendet haben, wurde die CLI über npm install -g openclaw@latest hinzugefügt, daher reicht npm rm -g openclaw aus.
API-Schlüssel und Webhooks widerrufen
Die lokale Deinstallation macht externe Tokens nicht ungültig. Öffnen Sie jeden verbundenen Dienst (Google Cloud Console, Slack App Dashboard, Discord Developer Portal, Notion-Integrationen, GitHub-Tokens) und widerrufen Sie die für OpenClaw generierten Anmeldedaten. Rotieren Sie gemeinsam genutzte Secrets überall dort, wo sie wiederverwendet wurden.
Bereinigung prüfen und nächste Installation planen
- Prozesse & Dienste: macOS:
launchctl list | grep openclaw - Linux:
systemctl --user status openclaw-gateway.service - Windows:
Get-Process OpenClaw*undschtasks /Query /TN "OpenClaw Gateway" - Binary-Prüfung:
which openclaw(macOS/Linux) oderGet-Command openclaw(PowerShell) sollte "not found" zurückgeben. - Dateisystemprüfung:
ls ~/.openclawundls ~/.openclaw-*sollten "No such file or directory" ausgeben. - Weiteres Vorgehen: Wenn Sie deinstallieren, um auf einen Managed Host oder einen neuen Rechner umzuziehen, dokumentieren Sie vor dem Löschen der Backups, ob Sie lokal neu installieren, ein Remote-Gateway starten oder zu einer gehosteten Control Plane migrieren.
Ihr KI-Rezeptionist ist in Minuten live.
Skalieren Sie Ihren Empfang mit einer KI, die nie schläft. Solvea bearbeitet unbegrenzte Anfragen über mehrere Kanäle, bucht Termine automatisch in Ihren Kalender und verhindert rund um die Uhr verpasste Chancen.
FAQ
Kann ich direkt nach dem Ausführen von openclaw uninstall neu installieren?
Ja. Der Befehl entfernt Statusdaten und Dienste, lässt globale Paketmanager jedoch intakt. Sobald die Bereinigungsprüfungen bestanden sind, führen Sie erneut npm install -g openclaw (oder das Installer-Skript) aus und richten Sie es wie einen neuen Rechner ein.
Was, wenn der Dienst nach dem Löschen der Dateien immer wieder neu startet?
Vermutlich haben Sie den launchd-/systemd-/schtasks-Eintrag übersehen. Führen Sie die obigen plattformspezifischen Befehle erneut aus und löschen Sie anschließend alle verbleibenden gateway.cmd- oder .service-Dateien, auf die Ihr Betriebssystem-Scheduler verweist.
Muss ich den Workspace löschen?
Nein, aber wenn ~/.openclaw/workspace zurückbleibt, verfehlt das den Zweck einer sauberen Deinstallation. Archivieren Sie ihn an einem anderen Ort, wenn Sie historische Transkripte behalten möchten, und entfernen Sie ihn dann von dem Rechner, den Sie bereinigen.
Wie gehe ich mit Remote-Gateways um?
Wiederholen Sie die Deinstallationsschritte auf dem Remote-Host, auf dem der Gateway-Dienst läuft. Der Befehl openclaw uninstall entfernt nur den Status des lokalen Rechners; Remote-Hosts müssen daher separat bereinigt werden.
