⚡ 官方一键卸载
如果你的 openclaw 命令还能正常使用,这是最简单、最推荐的卸载方式。
交互式卸载(推荐)
打开终端,输入以下命令:
openclaw uninstall
系统会逐步提示你要删除哪些内容——包括 gateway 服务、配置文件、工作区等。你可以根据提示逐项确认,不用担心误删。
交互式卸载的好处是,你可以选择性地保留某些数据(比如聊天记录),而只删除服务和 CLI。
非交互式卸载(自动化场景)
如果你在脚本、CI/CD 或自动化流程中需要静默卸载:
openclaw uninstall --all --yes --non-interactive
如果你没有全局安装 openclaw,可以用 npx 临时调用:
npx -y openclaw uninstall --all --yes --non-interactive
--all 参数会删除所有数据,包括配置文件、聊天记录、工作区。执行前请确认你不需要这些数据,或已经做好备份。
一键卸载做了什么?
这条命令会自动执行以下操作:
- 停止 Gateway 服务 — 终止后台运行的网关进程
- 移除服务守护进程 — 删除开机自启配置(launchd / systemd / 计划任务)
- 清理状态和配置 — 删除
~/.openclaw目录下的配置文件 - 删除工作区 — 移除 AI 创建的工作区文件
- 卸载 CLI — 从全局包管理器中移除 openclaw 命令
虽然一键卸载覆盖了大部分清理工作,但我仍建议你在卸载后做一次深度清理检查,确保系统完全干净。养成好习惯。
如果一键卸载失败了?
以下情况可能导致一键卸载无法正常工作:
- CLI 工具已损坏或已被手动删除
- 权限不足(特别是系统级安装的情况)
- 环境变量被修改导致找不到安装路径
别担心,这时候请转到 手动卸载教程,按步骤操作即可。