OpenClaw unter Linux deinstallieren ohne verwaiste systemd-Units

Linux führt das OpenClaw-Gateway als systemd-Dienst auf Benutzerebene aus. Deshalb ist für die Deinstallation mehr erforderlich, als nur die Binärdatei zu entfernen. Units, Sockets und Profilverzeichnisse können bestehen bleiben und Ihr System weiter beeinflussen.

Diese Anleitung führt Sie durch einen sauberen Entfernungsprozess, damit keine übrig gebliebenen Dienste, Dateien oder Konfigurationen verbleiben.

TL;DR

Linux für die Deinstallation vorbereiten

1. Speichert Workspaces, Cron-Logs und Secrets für spätere Wiederherstellungen.
2. Profile auflisten: Führen Sie ls -d ~/.openclaw* aus, um alle Standard- und profilierten Statusverzeichnisse zu sehen.
3. Remote-Gateways finden: Notieren Sie alle Remote-Hosts, auf denen das Gateway ebenfalls läuft. Dort wiederholen Sie die Bereinigung später.

Gateway-Unit stoppen und deinstallieren

1. gateway uninstall entfernt die systemd-Unit und den Socket über die CLI.
2. Der vereinheitlichte Befehl openclaw uninstall führt diese Schritte automatisch aus.

systemd-User-Units und Sockets entfernen

Prüfen Sie noch einmal, dass keine Units verbleiben:

Wenn Sie Profile verwendet haben, wiederholen Sie dies mit openclaw-gateway-<profile>.service. Verwenden Sie systemctl --user list-units | grep openclaw, um zu bestätigen, dass nichts aktiv ist. (Referenz: systemd-systemctl-Manpage)

Bereinigung übrig gebliebener OpenClaw-Dateien unter Linux

1. Workspace + Logs: Entfernen Sie ~/.openclaw/workspace, ~/.openclaw/logs und alle benutzerdefinierten Workspace-Pfade (/srv/agents/...).
2. Cache-Verzeichnisse: Wenn Sie Cache-Dateien unter /var/tmp/openclaw oder an ähnlichen Orten gespeichert haben, löschen Sie auch diese.
3. Editoren/Terminals: Entfernen Sie bei Bedarf Shell-History-Einträge, die Secrets enthalten (history -d oder sed -i in .bash_history).

CLI und Shell-Artefakte entfernen

Wenn Sie das Repo geklont haben, statt global zu installieren, löschen Sie den Klon, nachdem Sie das Gateway heruntergefahren haben. Entfernen Sie alle benutzerdefinierten Shell-Completions oder Aliasse mit Bezug auf OpenClaw aus ~/.bashrc, ~/.zshrc oder ~/.config/fish/config.fish.

API-Schlüssel und Remote-Hosts widerrufen

1. Widerrufen Sie OAuth-Tokens (Slack, Google, Notion, GitHub, Discord usw.), die mit dieser Linux-Maschine verknüpft waren.
2. Entfernen Sie SSH-Schlüssel oder Deploy-Tokens, wenn Sie OpenClaw Zugriff auf private Git-Repos gewährt haben.
3. Wenn Sie Remote-Gateways betrieben haben, wiederholen Sie die Schritte zur Gateway-Deinstallation auf jedem Host, damit kein Hintergrunddienst verbleibt.

Deinstallation prüfen und nächste Schritte

1. sollte „Unit openclaw-gateway.service could not be found.“ ausgeben.
2. Binärdatei prüfen: which openclaw sollte nichts zurückgeben.
3. Dateisystem prüfen: ls ~/.openclaw ~/.openclaw-* sollte „No such file or directory.“ ausgeben.
4. Journal prüfen: journalctl --user -u openclaw-gateway.service sollte nur ältere Einträge anzeigen, keine neuen.

Sobald alles bereinigt ist, installieren Sie OpenClaw auf derselben Maschine neu oder migrieren Sie zu einem neuen Host.

FAQ

Benötige ich sudo für irgendeinen Befehl?

Nein. OpenClaw verwendet systemd-Units auf Benutzerebene. Führen Sie die Befehle als derselbe Benutzer aus, der das Gateway installiert hat.

Wie bereinige ich Docker- oder Podman-Sandboxes?

Stoppen und entfernen Sie alle Container/Images, die auf OpenClaw verweisen: docker rm <container> → docker rmi <image> (oder die Podman-Entsprechungen), um Registries sauber zu halten.

Kann ich das Löschen des Workspace überspringen?

Nur wenn Sie lokale Transkripte behalten möchten. Andernfalls verschieben Sie die Dateien an einen anderen Ort und löschen die Originale, um eine saubere Deinstallation zu garantieren.

Was, wenn systemctl --user meldet, dass der Dienst maskiert ist?

Führen Sie zuerst systemctl --user unmask openclaw-gateway.service aus und führen Sie anschließend die Disable-/Remove-Befehle erneut aus.