⚡ 官方一键卸载

如果你的 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 工具已损坏或已被手动删除
  • 权限不足(特别是系统级安装的情况)
  • 环境变量被修改导致找不到安装路径

别担心,这时候请转到 手动卸载教程,按步骤操作即可。