简单方式(CLI仍已安装)
如果 OpenClaw CLI 仍然可用,使用内置卸载程序是最简单的方法:
交互式卸载
bash
openclaw uninstall
非交互式卸载(自动化/npx)
bash
openclaw uninstall --all --yes --non-interactive
⚠️ 注意事项
非交互式模式会跳过所有确认提示,请确保你知道自己在做什么。
手动步骤(效果相同)
如果你需要更精细的控制,或 CLI 不可用,可以按照以下步骤手动卸载:
-
停止 Gateway 服务
bash
openclaw gateway stop -
卸载 Gateway 服务
根据系统不同,移除 launchd/systemd/schtasks 服务:
bashopenclaw gateway uninstall -
删除状态+配置目录
bash
rm -rf "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}" -
删除工作区(可选)
bash
rm -rf ~/.openclaw/workspace -
移除 CLI 安装
根据你使用的包管理器选择对应命令:
bash# npm npm rm -g openclaw # pnpm pnpm remove -g openclaw # bun bun remove -g openclaw -
删除 macOS 应用(如有)
bash
rm -rf /Applications/OpenClaw.app
手动服务移除(CLI未安装)
如果 CLI 已卸载但需要清理残留的服务,请根据操作系统执行以下操作:
macOS(launchd)
bash
# 停止并移除服务
launchctl bootout user/$(id - u)/com.openclaw.gateway
# 删除 plist 文件
rm ~/Library/LaunchAgents/com.openclaw.gateway.plist
Linux(systemd)
bash
# 停止并禁用服务
systemctl --user disable --now openclaw-gateway
# 删除 service 文件
rm ~/.config/systemd/user/openclaw-gateway.service
Windows(计划任务)
cmd
# 删除计划任务
schtasks /Delete /TN "OpenClaw Gateway" /F
# 删除 gateway.cmd(如有)
del "%LOCALAPPDATA%\openclaw\gateway.cmd"
普通安装 vs 源码检出
普通安装(install.sh/npm/pnpm/bun)
通过包管理器安装的 OpenClaw,使用以下命令移除:
bash
npm rm -g openclaw
源码检出(git clone)
从源码构建安装的 OpenClaw,按以下顺序清理:
- 先卸载服务:
openclaw gateway uninstall - 再删除仓库目录:
rm -rf /path/to/openclaw - 最后移除状态+工作区:
rm -rf ~/.openclaw
⚠️ 清理顺序很重要
务必先卸载服务,再删除文件。如果顺序颠倒,可能导致系统残留无效的服务配置。