最完整的卸载 OpenClaw(龙虾) 方案

分为两种场景,按需选择对应路径即可,全程清晰可复制,避免残留~

一、简易路径(CLI 仍然可用,最省事)

如果 CLI 命令还能正常使用,优先走这条路径,操作最简单,无需手动多步排查。

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 设置到了状态目录之外的自定义路径,那个文件也需要手动删除,否则会有残留。

第四步:删除 workspace(可选,但建议执行,清除 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

二、手动清理路径(CLI 已不可用,但服务仍在运行)

如果 CLI 命令找不到,但网关服务还在后台运行,需根据操作系统分别处理,精准停止服务并清理残留。

1. macOS 用户

默认服务标签为 ai.openclaw.gateway,执行以下命令:

launchctl bootout gui/$UID/ai.openclaw.gateway

rm -f ~/Library/LaunchAgents/ai.openclaw.gateway.plist

补充:如果当时用了 --profile 参数,需要把命令里的标签和 plist 文件名替换为 ai.openclaw.<profile名>;此外,老版本 OpenClaw 遗留的 com.openclaw.* 格式 plist 如果还存在,也一并删除。

2. Linux 用户

默认服务单元名为 openclaw-gateway.service,执行以下命令:

systemctl --user disable --now openclaw-gateway.service

rm -f ~/.config/systemd/user/openclaw-gateway.service

systemctl --user daemon-reload

补充:使用了 --profile 的,对应单元名为 openclaw-gateway-<profile名>.service,在命令中替换即可。

3. Windows 用户

默认任务名为 OpenClaw Gateway,执行以下命令(可在 PowerShell 中运行):

schtasks /Delete /F /TN "OpenClaw Gateway"

Remove-Item -Force "$env:USERPROFILE\.openclaw\gateway.cmd"

补充:使用了 --profile 的,任务名对应为 OpenClaw Gateway (<profile名>),同时删除 ~/.openclaw-<profile名>/gateway.cmd。

容易漏掉的3个关键细节(必看,避免残留)

1. 多 profile 情况

如果当时用 --profile 参数创建了多个配置,每个 profile 都有独立的状态目录,默认路径是 ~/.openclaw-<profile名>,需要逐一找出来、逐一删除,一个都不能漏,否则残留数据还在。

2. 远程模式情况

如果用的是远程模式,状态目录不在本机,而是在网关主机上。这意味着:停止服务、删除状态目录这几步,需要登录到网关主机上去执行,仅在本机操作是不够的。

3. 源码方式安装情况

如果当时是通过 git clone 拉取源码运行的,卸载顺序很重要——必须先卸载网关服务(走上面的简易路径或手动清理路径),再删除仓库目录,最后清理状态和 workspace。顺序不能反,否则服务还挂着,删了仓库反而清理不干净。

做完以上所有步骤,才算真正彻底卸载 OpenClaw,和这只“龙虾”正式说再见啦~