一、官方卸载方式(推荐优先使用)
-
自动卸载命令
- 若CLI仍可用,直接运行以下命令(覆盖服务、配置、工作区等核心组件):
或通过
openclaw uninstall --all --yes --non-interactivenpx临时调用:注:此操作可能仍需手动检查残留文件,如多Profile或远程模式下的配置。npx -y openclaw uninstall --all --yes --non-interactive
- 若CLI仍可用,直接运行以下命令(覆盖服务、配置、工作区等核心组件):
-
扫尾检查
- 验证是否删除干净:
openclaw --version # 应提示“命令未找到” ls ~/.openclaw* # 检查配置目录是否残留
- 验证是否删除干净:
二、分步骤卸载(适用于CLI不可用或需精准控制)
-
停止并卸载服务
openclaw gateway stop openclaw gateway uninstall若命令失效,需按系统手动清理服务(见下文第三部分)。
-
删除配置与工作区
rm -rf ~/.openclaw ~/.openclaw-* ~/.openclaw/workspace注意:若自定义过
OPENCLAW_CONFIG_PATH或OPENCLAW_PROFILE,需同步清理对应路径。 -
移除CLI与GUI
- 包管理器安装:
npm rm -g openclaw # npm pnpm remove -g openclaw # pnpm brew uninstall openclaw # macOS Homebrew - 源码安装:需先卸载服务,再删除源码目录,避免服务引用失效路径。
- 包管理器安装:
三、强制卸载(服务残留时)
-
macOS
- 清理
launchd服务及配置文件:旧版本可能使用launchctl bootout gui/$UID/ai.openclaw.gateway rm -f ~/Library/LaunchAgents/ai.openclaw.*.plistcom.openclaw.*命名,需检查。
- 清理
-
Linux
- 移除
systemd服务:若为系统级安装,需使用systemctl --user disable --now openclaw-gateway.service rm -f ~/.config/systemd/user/openclaw-gateway.servicesudo删除/etc/systemd/system/下的文件
- 移除
-
Windows
- 删除计划任务与脚本:
若使用PowerShell,可替换为
schtasks /Delete /F /TN "OpenClaw Gateway" Remove-Item -Force "$env:USERPROFILE\.openclaw\gateway.cmd"Unregister-ScheduledTask
- 删除计划任务与脚本:
四、深度清理与验证
-
检查进程与端口
ps aux | grep -i openclaw # 查找残留进程 lsof -i :端口号 | grep openclaw # 检查监听端口 -
系统任务与缓存
- 查看
crontab、systemd或计划任务中的残留项。 - 清理npm缓存(若通过npm安装):
npm cache clean --force
- 查看
-
Docker环境
- 直接删除容器与镜像即可,无宿主机残留:
适用于容器化部署用户
docker rm -f openclaw_container docker rmi openclaw_image
- 直接删除容器与镜像即可,无宿主机残留:
五、注意事项与扩展建议
-
多环境与远程模式
- 若使用
--profile或远程网关,需在对应主机重复卸载步骤 - 检查
\~/.openclaw-<profile>和远程服务器配置。
- 若使用
-
安全与备份
- API Key:删除未使用的模型API Key,避免泄露
- 配置备份:如需保留设置,备份
\~/.openclaw目录或导出聊天记录。
-
云服务器
- 若为临时使用,及时释放云资源,避免持续计费
常见问题补充
- 权限不足:在Linux/macOS中,对系统目录操作需加
sudo - 残留检测:Windows用户可使用[脚本之家](提供的检测工具一键验证
- 旧版本兼容:早期版本可能使用
clawdbot等命名,需调整命令关键词
通过以上步骤,可确保OpenClaw卸载彻底,避免残留文件或服务占用资源。
