【教程】OpenClaw龙虾卸载指南
一、简易路径（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 已不可用，但服务仍在运行）
当命令行工具已经“失联”，可后台服务却还在默默运行，这种情况就需要我们根据不同的操作系统来“对症下药”，精准地停止服务并清理所有残留。
1. macOS 用户
服务的默认标签是ai.openclaw.gateway，执行下面这两条命令即可：
launchctl bootout gui/$UID/ai.openclaw.gateway
rm -f ~/Library/LaunchAgents/ai.openclaw.gateway.plist
有两点需要留意：如果你当初创建服务时使用了 --profile 参数，记得把上面命令里的标签和 plist 文件名替换成 ai.openclaw. 的格式。另外，检查一下是否还有老版本 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-，在命令中做相应的替换就行。
3. Windows 用户
默认的计划任务名是“OpenClaw Gateway”，在 PowerShell 中运行以下命令：
schtasks /Delete /F /TN "OpenClaw Gateway"
Remove-Item -Force "$env:USERPROFILE\.openclaw\gateway.cmd"
补充说明：对于使用了 --profile 的情况，任务名会对应为“OpenClaw Gateway (~/.openclaw- 这个文件。
三、容易漏掉的3个关键细节（必看，避免残留）
1. 多 profile 情况
如果你曾经用 --profile 参数创建过多个配置环境，那么每个 profile 都会拥有自己独立的状态目录，默认路径是 ~/.openclaw-。卸载时必须把它们一个个找出来、挨个删除，漏掉任何一个，残留数据都会继续占用你的磁盘空间。
2. 远程模式情况
当你运行在远程模式下时，关键的状态目录并不在你的本地机器上，而是位于网关主机中。这意味着，仅仅在本机执行停止服务、删除目录的操作是远远不够的。你必须登录到那台远程网关主机上，把相应的步骤再执行一遍，才能算彻底清理干净。
3. 源码方式安装情况
如果你是通过 git clone 拉取源码方式安装和运行的，那么卸载的顺序就显得尤为重要。正确的流程是：必须先按照上面“简易路径”或“手动清理路径”的步骤卸载网关服务，然后再删除本地的源码仓库目录，最后才清理状态目录和 workspace。这个顺序千万不能颠倒，否则服务进程可能还在运行，你删了仓库反而会让清理工作无法进行到底。