Openclaw 龙虾卸载指南

卸载分两条路：CLI 还在的，走简易路径；CLI 已经找不到但服务还在跑的，走手动清理路径。

简易路径（CLI 仍然可用

最省事的方式是用它自带的卸载命令：

openclaw uninstall

想一键清除所有配置、跳过所有确认提示，加参数：

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

如果你习惯用 npx，也可以：

npx-yopenclaw uninstall--all--yes--non-interactive

如果想手动一步步来，效果完全一样，按顺序执行：
第一步，停止网关服务：

openclaw gateway stop

第二步，卸载网关服务本身：

openclaw gateway uninstall

第三步，删除本地状态与配置文件：

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

注意：如果你当时把 OPENCLAW_CONFIG_PATH 设置到了状态目录之外的自定义路径，那个文件也需要手动删除，否则会有残留。
第四步，删除 workspace（可选，但建议执行，会一并清除 Agent 运行时产生的文件）：

rm-rf~/.openclaw/workspace

第五步，卸载 CLI 本体，根据当时的安装方式选择对应命令：

# npm 安装的npmrm-gopenclaw# pnpm 安装的pnpmremove-gopenclaw# bun 安装的bun remove-gopenclaw

如果还安装了 macOS 桌面版，记得一并处理：

rm-rf/Applications/OpenClaw.app

手动清理路径（CLI 已不可用，但服务仍在运行）
如果 CLI 已经找不到了，但网关服务还在后台默默跑着，就需要根据操作系统分别处理。

macOS 用户：
默认服务标签为ai.openclaw.gateway，执行：

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

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

Linux 用户：
默认服务单元名为openclaw-gateway.service，执行：

systemctl--userdisable--nowopenclaw-gateway.servicerm-f~/.config/systemd/user/openclaw-gateway.service systemctl--userdaemon-reload

使用了 --profile 的，对应单元名为 openclaw-gateway-<profile名>.service，命令里替换即可。

Windows 用户：
默认任务名为 OpenClaw Gateway，执行：

schtasks /Delete /F /TN"OpenClaw Gateway"Remove-Item-Force"$env:USERPROFILE\.openclaw\gateway.cmd"

使用了–profile 的，任务名对应为 OpenClaw Gateway (<profile名>)_，同时删除 _~.openclaw-<profile名>\gateway.cmd。

几个容易漏掉的细节

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

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

• 源码方式安装的情况： 如果你当时是通过 git clone 拉取源码运行的，卸载顺序很重要——必须先卸载网关服务（走上面的简易路径或手动清理路径），再删除仓库目录，最后清理状态和 workspace。顺序不能反，否则服务还挂着，删了仓库反而清理不干净。
  做完这些，才算真的和这只龙虾说了再见。