简易路径:CLI 还能用的情况

CLI 命令正常可用时,优先走这条路,最省事。

一键卸载(推荐),跳过所有确认提示,直接执行:

openclaw gateway uninstall --yes --purge

用 npx 安装的也可以执行:

npx openclaw gateway uninstall --yes --purge

手动分步卸载,效果一样,但每步可控:

  1. 停止网关服务:openclaw gateway stop
  2. 卸载网关服务:openclaw gateway uninstall
  3. 删除本地状态与配置:rm -rf ~/.openclaw
  4. 删除 workspace(清除 Agent 运行时文件):rm -rf ~/.openclaw-workspace
  5. 卸载 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。顺序反了,服务还挂着,删了仓库反而清理不干净。


说实话,从爆火到官方预警也就几天的事。工具好不好用是一回事,安全配置没做好就裸跑在公网上是另一回事。卸载之前,也值得想一下:问题到底出在工具本身,还是出在默认配置太激进。如果后续官方修复了安全策略,重新装回来也不迟——但至少现在,先确保自己的环境是干净的。