OpenClaw Deinstallationsanleitung

Dieser Artikel erklärt, wie OpenClaw vollständig deinstalliert wird, einschließlich CLI, Gateway-Dienst, Konfigurationsdateien und Workspace-Daten.

Es gibt zwei Szenarien für die Deinstallation von OpenClaw:

  • CLI ist noch vorhanden (empfohlene Vorgehensweise)
  • CLI wurde gelöscht, aber Hintergrunddienste laufen noch (manuelle Bereinigung)

I. Empfohlene Vorgehensweise (CLI ist noch vorhanden)

Wenn der Befehl openclaw auf Ihrem System noch ausgeführt werden kann, wird empfohlen, den integrierten Deinstallationsbefehl zu verwenden.

1. Standard-Deinstallation

openclaw uninstall

Dieser Befehl löscht:

  • Gateway-Dienst
  • Lokale Zustandsdaten
  • Konfigurationsdateien
  • Daten wie das Agent-Workspace-Verzeichnis

2. Nicht-interaktive Deinstallation (Automatisierungsskripte)

Geeignet für CI- oder automatisierte Skriptumgebungen:

# 直接执行
openclaw uninstall --all --yes --non-interactive

# 无本地 CLI 时，通过 npx 执行
npx -y openclaw uninstall --all --yes --non-interactive
  • uninstall: Deinstallationsprogramm
  • --all: Entfernt Dienste und lokale Daten zusammen (einschließlich Gateway-Dienst, Konfigurationsdateien, Datenbank usw.)
  • --yes: Bestätigt automatisch, sodass Sie nicht wiederholt manuell Y eingeben müssen

II. Manuelle Deinstallation (Vollständige Bereinigung)

Wenn Sie vollständige Kontrolle über den Deinstallationsprozess wünschen, können Sie manuell bereinigen, indem Sie die folgenden Schritte ausführen.

1. Gateway-Dienst stoppen

openclaw gateway stop

2. Gateway-Dienst deinstallieren

openclaw gateway uninstall

Dieser Schritt entfernt die Hintergrunddienste aus dem System:

  • macOS：launchd
  • Linux：systemd
  • Windows：Geplante Aufgaben

3. Konfigurations- und Statusverzeichnisse löschen

rm -rf "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}"

Standardverzeichnisse:

~/.openclaw

Diese umfassen:

  • Konfigurationsdateien
  • Token
  • Sitzung
  • Protokolle
  • Agent-Statusdaten

Wenn benutzerdefinierte Umgebungsvariablen gesetzt wurden:

OPENCLAW_CONFIG_PATH

Sie müssen auch die entsprechenden Dateien manuell löschen.

4. Agent-Workspace löschen (optional)

rm -rf ~/.openclaw/workspace

Dieses Verzeichnis speichert normalerweise:

  • Vom Agent generierter Code
  • Dateien zur Aufgabenausführung
  • Zwischendaten

5. CLI löschen

Wählen Sie den entsprechenden Befehl basierend auf der Installationsmethode aus:

# npm 安装
npm rm -g openclaw

# pnpm 安装
pnpm remove -g openclaw

# bun 安装
bun remove -g openclaw

6. macOS-App löschen (falls installiert)

rm -rf /Applications/OpenClaw.app

III. CLI verloren, aber Dienste laufen noch

Wenn Sie die CLI bereits gelöscht haben, OpenClaw Gateway aber noch im Hintergrund läuft, können Sie den Systemdienst manuell löschen.

1. macOS (launchd-Dienst)

Standarddienst-Label:bot.molt.gateway(Für Multi-Konfiguration:bot.molt.<profile>, für ältere Versionen:com.openclaw.*）

# 停止并卸载服务
launchctl bootout gui/$UID/bot.molt.gateway

# 删除服务配置文件
rm -f ~/Library/LaunchAgents/bot.molt.gateway.plist

# 多配置场景：替换为对应 profile 标签
# launchctl bootout gui/$UID/bot.molt.<profile>
# rm -f ~/Library/LaunchAgents/bot.molt.<profile>.plist

# 清理旧版残留（如有）
rm -f ~/Library/LaunchAgents/com.openclaw.*.plist

2. Linux (systemd-Benutzerdienst)

Standarddienstname:openclaw-gateway.service(Für Multi-Konfiguration:openclaw-gateway-<profile>.service）

# 停止并禁用服务
systemctl --user disable --now openclaw-gateway.service

# 删除服务配置文件
rm -f ~/.config/systemd/user/openclaw-gateway.service

# 刷新 systemd 配置
systemctl --user daemon-reload

# 多配置场景：替换为对应 profile 服务名
# systemctl --user disable --now openclaw-gateway-<profile>.service
# rm -f ~/.config/systemd/user/openclaw-gateway-<profile>.service
# systemctl --user daemon-reload

3. Windows (Geplante Aufgabe)

Standardaufgabenname:OpenClaw Gateway(Für Multi-Konfiguration:OpenClaw Gateway (<profile>)）

# 删除计划任务
schtasks /Delete /F /TN "OpenClaw Gateway"

# 删除任务脚本
Remove-Item -Force "$env:USERPROFILE\.openclaw\gateway.cmd"

# 多配置场景：替换为对应 profile 任务名
# schtasks /Delete /F /TN "OpenClaw Gateway (<profile>)"
# Remove-Item -Force "$env:USERPROFILE\.openclaw-<profile>\gateway.cmd"

IV. Deinstallieren von Docker-Installationen

Wenn OpenClaw in Docker ausgeführt wird:

docker stop openclaw
docker rm openclaw
docker volume rm openclaw-data

oder

docker-compose down -v

V. Deinstallieren einer Quellinstallation (git clone)

Bei Installation viagit cloneQuellinstallation müssen Sie zuerst den Dienst bereinigen und dann den Quellcode und die Konfiguration löschen:

  1. Führen Sie zuerst die "empfohlene Deinstallationsmethode" aus oder "bereinigen Sie Dienstüberreste manuell", um den Gateway-Dienst zu stoppen und zu deinstallieren

  2. Löschen Sie das Quell-Repository-Verzeichnis

    # 替换为你的源码路径
rm -rf /path/to/openclaw-repo
  3. Löschen Sie die Status-, Konfigurations- und Workspace-Verzeichnisse gemäß den vorherigen Schritten

VI. Empfohlenes Backup vor der Deinstallation

Wenn Sie Daten behalten möchten, können Sie zuerst ein Backup erstellen:

openclaw backup create

Fahren Sie dann mit der Deinstallation fort.

Überprüfung der Deinstallation

Nach der Deinstallation können Sie auf folgende Weise überprüfen, ob die Bereinigung vollständig ist:

  • Führen Sieopenclaw --version, wenn "command not found" angezeigt wird, wurde die CLI erfolgreich deinstalliert
  • Systemdienste prüfen:
    • macOS：launchctl list | grep moltKeine Ausgabe
    • Linux：systemctl --user list-units | grep openclawKeine Ausgabe
    • Windows: Keine "OpenClaw Gateway"-bezogenen Aufgaben im Aufgabenplaner
  • Verzeichnisse prüfen:~/.openclaw(und Multi-Konfiguration~/.openclaw-<profile>) wurden gelöscht

VII. Häufige Restverzeichnisse

Bei einer vollständigen Deinstallation wird empfohlen, die folgenden Verzeichnisse zu prüfen:

~/.openclaw
~/.openclaw/workspace
~/Library/LaunchAgents/ai.openclaw.gateway.plist
~/.config/systemd/user/openclaw-gateway.service
Weitere Erweiterungen