方案一：命令行还能用？走快速通道

如果 openclaw 指令还能正常响应，这是最省事的卸载方式。

1. 一键卸载（懒人首选）

直接执行，跳过所有确认弹窗，连配置带数据一次性清除：

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

习惯用 npx 的话，这条等效：

npx -y openclaw uninstall --all --yes --non-interactive

2. 分步卸载（更可控）

如果想看清每一步在做什么，按这个顺序执行：

第一步：先停掉网关进程

openclaw gateway stop

第二步：卸掉网关服务

openclaw gateway uninstall

第三步：清理本地数据

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

注意：如果你当初把 OPENCLAW_CONFIG_PATH 指向了别的地方，那个配置文件也要手动删，否则配置残留。

第四步：清理工作目录（建议执行）

Agent 运行时产生的临时文件都在这里：

rm -rf ~/.openclaw/workspace

第五步：最后卸掉 CLI 本体

根据你当时的安装方式选对应命令：

# npm 安装的npm rm -g openclaw# pnpm 安装的pnpm remove -g openclaw# bun 安装的bun remove -g openclaw

补充：如果还安装了 macOS 桌面版，记得一并删除：

rm -rf /Applications/OpenClaw.app

方案二：命令行失效了？手动清理服务残留

如果输入 openclaw 提示"找不到命令"，但后台服务其实还在跑，就得按操作系统手动处理了。

1. macOS 系统

默认服务标识是 ai.openclaw.gateway，执行：

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

• 用了多配置（--profile）？把上面命令里的标签和文件名换成 ai.openclaw.<你的profile名> 即可。

• 老版本遗留？检查并删除旧格式的 com.openclaw.* plist 文件。

2. Linux 系统

默认服务单元叫 openclaw-gateway.service：

# 停止并禁用服务systemctl --user disable --now openclaw-gateway.service# 删除服务文件rm -f ~/.config/systemd/user/openclaw-gateway.service# 重载 systemdsystemctl --user daemon-reload

多配置用户：服务名会变成 openclaw-gateway-<profile名>.service，对应替换即可。

3. Windows 系统

默认计划任务名为 "OpenClaw Gateway"，在 PowerShell 执行：

# 删除计划任务schtasks /Delete /F /TN "OpenClaw Gateway"# 删除网关脚本Remove-Item -Force "$env:USERPROFILE\.openclaw\gateway.cmd"

多配置情况：任务名会变成 "OpenClaw Gateway (<profile名>)"，同时删除 ~/.openclaw-<profile名>/gateway.cmd。

三、三个容易踩的坑（必读）

1. 多 profile 情况

如果当初用 --profile 创建过多个隔离配置，每个都有独立的状态目录（~/.openclaw-<profile名>）。必须逐个清理，漏掉任何一个都会有数据残留。

2. 远程模式情况

如果你连接的是远程网关，状态目录根本不在本机！这时候在本机执行删除命令是没用的——需要 SSH 登录到网关所在服务器，在那里执行停止服务和清理状态的操作。

3. 源码方式安装情况

如果是 git clone 源码运行的，顺序至关重要：

• 先按上面方案卸载网关服务

• 再删除源码仓库目录

• 最后清理状态和 workspace

顺序反了的话，服务还挂在系统里，删了源码反而找不到卸载入口，变成"幽灵服务"。

总结：卸载 OpenClaw 的核心逻辑是——先停服务，再删数据，最后卸本体。多配置环境要逐个处理，远程模式要到主机上操作，源码安装注意先后顺序。按这个指南走，基本能做到无残留清理。