如何卸载openclaw
OpenClaw完整卸载指南:告别“龙虾”,一步不留
OpenClaw,也就是大家常说的“龙虾”,是一个颇受欢迎的本地AI智能体平台。不过,有时候你可能需要将它从电脑上彻底请走——无论是为了释放空间,还是解决某个棘手的配置问题。经验表明,一个不留神,它那些后台服务和配置文件就可能“潜伏”下来。所以,今天我们就来把这个“龙虾”剥壳拆肉,确保卸载得干干净净。
第一步:先别急着动手,停止运行中的服务
直接卸载往往是问题症结所在。在动刀之前,必须先让后台的网关服务安静下来。这就需要我们打开终端,输入下面的命令:
openclaw gateway stop
# 或者也可以试试
openclaw daemon stop
简单来说,这就好比在关掉电脑前先保存所有文档,一个意思。
第二步:执行官方卸载命令,解除核心武装
服务停稳了,就可以进入正餐环节。这是卸载的主步骤,目的是移除核心的服务组件。
# 基础卸载(交互式,需要手动确认)
openclaw uninstall
# 全自动卸载(推荐,无需手动确认)
openclaw uninstall --all --yes --non-interactive
选择后一条命令,省心省力。执行后,如果系统跳出选择界面,一定记得用空格键把所有选项(Gateway service、State + config、Workspace)都勾选上,然后回车确认。这一点,至关重要。
第三步:送佛送到西,卸载CLI命令行工具
核心服务卸掉了,但当初安装时使用的包管理器里还留着它的“名片”。这个也得清理,根据你当初的安装方式对号入座:
如果你是使用 npm 安装的:
npm uninstall -g openclaw
# 或者更简洁的写法
npm rm -g openclaw
使用 pnpm 安装的用户:
pnpm remove -g openclaw
而 bun 用户则对应这条命令:
bun remove -g openclaw
第四步:清理残留配置文件,这是关键步骤
官方卸载命令并不总是那么尽责,至少配置文件目录它通常不会主动删除。这些残留文件往往是导致后续问题的元凶,所以必须手动清理干净。
对于 macOS 或 Linux 用户,打开终端执行:
# 删除主配置目录
rm -rf ~/.openclaw
# 删除旧版本可能遗留的目录(以防万一)
rm -rf ~/.clawdbot ~/.moltbot ~/.molthub ~/.config/openclaw
Windows 用户请根据你的终端选择命令。如果用的是 PowerShell:
Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw"
Remove-Item -Recurse -Force "$env:USERPROFILE\.clawdbot"
Remove-Item -Recurse -Force "$env:APPDATA\OpenClaw"
如果习惯使用传统的 CMD:
rmdir /s /q "%USERPROFILE%\.openclaw"
第五步:清理系统启动项,根除自启动
为了确保它不会在开机时“阴魂不散”,我们还需要检查一下系统启动项。
macOS 用户需要检查并删除启动代理文件:
rm ~/Library/LaunchAgents/bot.molt.gateway.plist
rm ~/Library/LaunchAgents/ai.openclaw.gateway.plist
Linux 用户则可以通过 systemd 来操作:
systemctl --user disable --now openclaw-gateway.service
Windows 用户需要打开“任务计划程序”,在里面找到并删除那个名为 “OpenClaw Gateway” 的定时任务。
第六步:最后验收,验证卸载成功
大功告成后,总得验收一下成果。最直接的验证方法就是在终端里输入:
openclaw --version
如果系统返回的是“command not found”或“不是内部或外部命令”,那么恭喜你,说明卸载已经成功了。
重要安全提醒,别忽略收尾工作
事情到这里还没完,还有些收尾的安全事项必须提一嘴:
撤销 API Key:如果你之前在 OpenClaw 里配置过 OpenAI、Claude、Gemini 等平台的 API Key,强烈建议你现在就去对应的官网,把那个旧的 Key 废除掉,然后重新生成一个新的。这能有效防止密钥通过残留信息泄露,市场上不乏因为忽视这一步而导致损失的真实案例。
Docker 安装用户:如果你当初是通过 Docker 安装的 OpenClaw,那么还需要多执行几条命令来清理容器和镜像:
docker compose down --volumes --remove-orphans
docker image prune -f
权限问题:如果在执行删除命令时遇到权限错误(Permission denied),在 macOS 或 Linux 的命令前加上 sudo,或者在 Windows 上以管理员身份重新打开终端即可。
完成以上所有步骤后,为了让系统状态彻底刷新,重启一次电脑永远是最稳妥的选择。