OpenClaw 卸载教程：完整移除 Gateway 网关与本地数据
在使用一段时间之后，有些用户可能需要卸载 OpenClaw，例如重新部署、迁移服务器，或者更换运行环境。
OpenClaw 的卸载其实并不复杂，但需要注意：
不仅要删除 CLI，还要停止 Gateway 服务，并清理状态目录。
家兴网络整理了两种常见情况的卸载方法：
OpenClaw CLI 仍然存在（推荐方式）
CLI 已删除，但 Gateway 服务仍在运行
只要按步骤操作，就可以把 OpenClaw 从系统中完整移除。
一、推荐方式：使用 OpenClaw 内置卸载命令
如果你的系统中 OpenClaw CLI 仍然可用，最简单的方法是使用内置卸载程序。
1、执行卸载命令
openclaw uninstall
该命令会自动：
停止 Gateway 服务
删除系统服务
清理配置和状态文件
2、自动化卸载（适用于脚本环境）
如果是在 CI 或自动化环境，可以使用非交互模式：
openclaw uninstall --all --yes --non-interactive
或者使用 npx 直接执行：
npx -y openclaw uninstall --all --yes --non-interactive
这种方式适合服务器脚本或批量部署环境。
二、手动卸载 OpenClaw（完整步骤）
如果想自己控制每个步骤，也可以手动执行。
1、停止 Gateway 服务
openclaw gateway stop
2、卸载 Gateway 系统服务
openclaw gateway uninstall
该命令会移除系统服务，例如：
macOS 的 launchd
Linux 的 systemd
Windows 的计划任务
3、删除 OpenClaw 状态目录
OpenClaw 会在用户目录保存运行状态和配置。
默认路径：
~/.openclaw
删除方式：
rm -rf "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}"其中包含：
配置文件
认证信息
会话数据
Gateway 运行状态
如果你曾经设置过 OPENCLAW_CONFIG_PATH 指向其他路径，也需要手动删除。
4、删除 OpenClaw 工作区（可选）
如果你不再需要保存的智能体或脚本，可以删除工作区：
rm -rf ~/.openclaw/workspace
该目录通常存放：
Agent 文件
工作脚本
自定义配置
5、移除 OpenClaw CLI
根据安装方式不同，选择对应命令：
npm 安装
npm rm -g openclaw
pnpm 安装
pnpm remove -g openclaw
bun 安装
bun remove -g openclaw
6、删除 macOS 应用（如果安装过）
如果你安装过 macOS GUI 版本，可以删除应用：
rm -rf /Applications/OpenClaw.app
三、CLI 已删除但 Gateway 仍在运行
有时用户会先删除 CLI，但 Gateway 服务还在后台运行。
这时需要手动移除系统服务。
四、不同系统的手动服务卸载
macOS（launchd）
OpenClaw 默认服务标签：
bot.molt.gateway
卸载命令：
launchctl bootout gui/$UID/bot.molt.gateway rm -f ~/Library/LaunchAgents/bot.molt.gateway.plist
如果使用 profile，则可能为：
bot.molt.<profile>
另外，旧版本可能出现：
com.openclaw.*
也可以一并删除。
Linux（systemd）
默认服务名称：
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-<profile>.service
Windows（计划任务）
默认任务名称：
OpenClaw Gateway
删除任务：
schtasks /Delete /F /TN "OpenClaw Gateway"
删除任务脚本：
Remove-Item -Force "$env:USERPROFILE.openclawgateway.cmd"
如果使用 profile，则路径为：
~.openclaw-<profile>gateway.cmd
五、普通安装 vs 源码运行
OpenClaw 的安装方式不同，卸载步骤也略有区别。
普通安装（install.sh / npm）
如果你是通过官方安装脚本安装：
https://openclaw.ai/install.sh
CLI 实际上是通过 npm 全局安装：
npm install -g openclaw@latest
因此卸载只需要：
npm rm -g openclaw
源码运行（git clone）
如果你是通过源码运行：
git clone openclaw
那么卸载步骤是：
先停止 Gateway 服务
删除 Gateway 系统服务
删除状态目录
.openclaw删除仓库目录
六、卸载前需要注意的事项
在卸载 OpenClaw 之前，可以确认以下内容：
是否需要保留 Agent 文件
是否需要备份 配置和认证信息
是否正在使用 远程 Gateway
如果是远程模式：
状态目录在 Gateway 主机上，也需要在那里执行清理。
总结
完整卸载 OpenClaw 一般包含三个步骤：
停止并移除 Gateway 服务
删除状态目录与工作区
移除 CLI 程序
如果 CLI 仍然存在，建议直接使用：
openclaw uninstall
这样可以减少遗漏的情况。
如果 CLI 已被删除，则需要根据操作系统手动清理系统服务。
