卸载手册macOS / Linux / WindowsDocker / Podman / Nix / Ansible

OpenClaw 卸载完全指南

这不是“删个应用”那么简单：你需要处理后台 gateway 服务、状态/配置目录、容器化部署残留，以及（强烈建议）撤销你授予过的第三方权限与密钥。

推荐顺序

先 openclaw uninstall 或先停服务 → 再卸载 CLI。

一键复制

每段命令右上角都有复制按钮。

安全补刀

卸载后别忘了撤销 OAuth / 轮换 API Key。

Step 0

先定位：你是怎么装的？

不同安装方式，卸载路径不同。下面这张“分流卡片”能让你 10 秒定位到正确章节。

A. 本机普通安装

能运行 openclaw，且 UI/服务可能常驻后台。

去看看

B. CLI 不见了

openclaw 命令没了，但服务/端口/进程还在。

去看看

C/D. 容器（Docker/Podman）

你用过 docker-setup.sh 或 setup-podman.sh。

去看看

E/F. Nix / Ansible

你通过 nix-openclaw 或 openclaw-ansible 部署。

去看看

Step 1

官方卸载（CLI 还在）

如果 openclaw 命令还能运行，优先用它自带的卸载器。

1.1 一条命令（推荐）

适合大多数人：交互式卸载，按提示选择即可。

bash

openclaw uninstall

1.2 自动化 / 无人值守

适合自动化环境，避免交互提示。

bash

openclaw uninstall --all --yes --non-interactive

# 或者 npx 直接跑
npx -y openclaw uninstall --all --yes --non-interactive

Step 2

CLI 没了但服务还在

适用场景：openclaw 命令不存在，但后台服务仍在跑。

macOS (launchd)

默认 label：ai.openclaw.gateway（可能有历史名称）。先停服务再删 plist。

bash

launchctl bootout gui/$UID/ai.openclaw.gateway
rm -f ~/Library/LaunchAgents/ai.openclaw.gateway.plist

排查旧名字：

bash

ls -1 ~/Library/LaunchAgents | grep -Ei 'openclaw|clawd|clawdbot|molt'
launchctl list | grep -Ei 'openclaw|clawd|clawdbot|molt'

Linux (systemd user)

默认 unit：openclaw-gateway.service（profile 会带后缀）。

bash

systemctl --user disable --now openclaw-gateway.service
rm -f ~/.config/systemd/user/openclaw-gateway.service
systemctl --user daemon-reload

排查：

bash

systemctl --user list-unit-files | grep -i openclaw
systemctl --user status openclaw-gateway.service

Windows (Scheduled Task)

默认任务名：OpenClaw Gateway（profile 会带后缀）。

powershell

schtasks /Delete /F /TN "OpenClaw Gateway"
Remove-Item -Force "$env:USERPROFILE\.openclaw\gateway.cmd"

Step 3

删除残留

清理状态/配置/工作区与旧目录。

默认路径

状态/配置与工作区默认都在 ~/.openclaw

bash

rm -rf ~/.openclaw

旧品牌目录（可选）

若你用过旧版本，可检查这些目录。

bash

rm -rf ~/.clawdbot
rm -rf ~/clawdbot

Step 4

Docker / Podman

容器化网关卸载与宿主机数据清理。

Docker Compose

在仓库目录执行，停止并删除容器。

bash

docker compose down

docker compose down -v

删除宿主机持久化目录：

bash

rm -rf ~/.openclaw

Podman (rootless)

先停 Quadlet 服务（如使用），再移除容器与数据。

bash

sudo systemctl --machine openclaw@ --user stop openclaw.service
sudo -u openclaw podman rm -f openclaw

删除 Podman 模式下的宿主机数据：

bash

sudo rm -rf /home/openclaw/.openclaw
sudo rm -f /home/openclaw/.config/containers/systemd/openclaw.container
sudo systemctl --machine openclaw@ --user daemon-reload

Step 5

Nix / Ansible

适用于 Nix / Ansible 部署方式。

Nix / Home Manager

移除 nix-openclaw 模块或关闭开关，然后重新应用配置。

bash

home-manager switch

home-manager switch --rollback

如需清理数据，删除你的状态目录（可能是自定义路径）。

Ansible (openclaw-ansible)

先停服务并禁用，再清理安装目录与数据。

bash

sudo systemctl stop openclaw
sudo systemctl disable openclaw

sudo rm -rf /opt/openclaw
sudo rm -rf /home/openclaw/openclaw
sudo rm -rf /home/openclaw/.openclaw

如确定不再需要，可删除 openclaw 用户。

bash

sudo userdel -r openclaw

Step 6

卸载后自检

确认服务进程、端口与本地目录已清理。

Step 7

撤销访问与轮换密钥

卸载不等于撤销权限，建议完成最小安全动作。

至少完成以下三项：

轮换所有给过 OpenClaw 的 API Key（旧 key 作废）。
注销/移除可疑会话（聊天平台、邮箱、云控制台等）。
撤销第三方 OAuth / App 授权（Google/Microsoft/GitHub 等）。

不同平台入口不同，请按平台安全中心执行。