简易路径:CLI 还能用的情况
CLI 命令正常可用时,优先走这条路,最省事。
一键卸载(推荐),跳过所有确认提示,直接执行:
openclaw gateway uninstall --yes --purge
用 npx 安装的也可以执行:
npx openclaw gateway uninstall --yes --purge
手动分步卸载,效果一样,但每步可控:
- 停止网关服务:
openclaw gateway stop - 卸载网关服务:
openclaw gateway uninstall - 删除本地状态与配置:
rm -rf ~/.openclaw - 删除 workspace(清除 Agent 运行时文件):
rm -rf ~/.openclaw-workspace - 卸载 CLI 本体,根据安装方式选对应命令(npm/brew/手动安装各有不同)
这里有个坑:如果你把 OPENCLAW_CONFIG_PATH 设到了状态目录之外的自定义路径,那个文件不会被自动清理,需要手动删。
macOS 桌面版用户别忘了一并删除桌面应用。
手动清理路径:CLI 挂了但服务还在跑
CLI 找不到了,但网关服务还在后台运行——这种情况需要按操作系统分别处理。
macOS
默认服务标签 ai.openclaw.gateway,用 launchctl 停止并移除对应的 plist 文件。老版本遗留的 com.openclaw.* 格式 plist 如果还在,也一并清掉。
Linux
默认服务单元 openclaw-gateway.service,用 systemctl 停止、禁用、删除单元文件,然后 daemon-reload。
Windows
默认任务名 OpenClaw Gateway,在 PowerShell 中用 Unregister-ScheduledTask 删除计划任务,同时清理 ~/.openclaw/gateway.cmd。
三个容易漏掉的关键细节
多 profile 情况
用过 --profile 参数创建多个配置的,每个 profile 都有独立状态目录,默认路径 ~/.openclaw-<profile名>。必须逐一删除,漏一个就有残留。对应的服务标签/单元名也要替换为带 profile 名的版本。
远程模式情况
远程模式下,状态目录不在本机,在网关主机上。停止服务和删除状态目录这几步,必须登录到网关主机执行,本机操作不够。
源码安装情况
通过 git clone 跑的,卸载顺序很重要:先卸载网关服务,再删仓库目录,最后清理状态和 workspace。顺序反了,服务还挂着,删了仓库反而清理不干净。
说实话,从爆火到官方预警也就几天的事。工具好不好用是一回事,安全配置没做好就裸跑在公网上是另一回事。卸载之前,也值得想一下:问题到底出在工具本身,还是出在默认配置太激进。如果后续官方修复了安全策略,重新装回来也不迟——但至少现在,先确保自己的环境是干净的。