🔧 手动分步卸载
当一键卸载不可用时(比如 CLI 损坏了),按照以下步骤手动操作。顺序很重要——先停服务,再删文件,最后移除工具。
第 1 步:停止 Gateway 服务
首先,确保后台运行的网关服务被停止:
openclaw gateway stop
如果 openclaw 命令已经不可用了,跳过这一步,直接用系统命令强制停止(参见对应系统的专项清理页面)。
第 2 步:卸载服务守护进程
移除开机自启动配置,防止重启后服务又回来:
openclaw gateway uninstall
同样,如果 CLI 不可用,需要手动操作——macOS 清理 launchd,Linux 清理 systemd,Windows 清理计划任务。详见各系统专项页面。
第 3 步:删除配置和状态数据
OpenClaw 的所有配置文件、聊天记录、运行状态都存储在状态目录中:
rm -rf "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}"
如果你自定义过 OPENCLAW_STATE_DIR 环境变量,需要检查实际路径。默认情况下就是 ~/.openclaw。
这一步不可逆!所有聊天记录、自定义配置都会被删除。如果你可能以后还会用到,请先备份整个
~/.openclaw 目录。关于备份的详细建议,请看注意事项。
第 4 步:删除工作区文件(可选)
如果第 3 步已经删了整个 .openclaw 目录,这步可以跳过。否则单独清理工作区:
rm -rf ~/.openclaw/workspace
第 5 步:移除 CLI 工具
根据你当初安装 OpenClaw 的方式,选择对应的卸载命令:
npm 安装
npm rm -g openclaw
pnpm 安装
pnpm remove -g openclaw
Bun 安装
bun remove -g openclaw
Homebrew 安装(macOS)
# CLI 版本
brew uninstall openclaw-cli
# 桌面应用版本
brew uninstall --cask openclaw
源码安装(git clone)
如果是从源码安装的,确保先完成前面的服务停止和卸载步骤,然后直接删除源码目录即可。一定要先停服务再删目录,否则服务可能会引用已删除的路径导致报错。
多 Profile 安装
如果你使用了自定义 Profile(比如一个用于工作、一个用于个人),每个 Profile 有独立的状态目录,需要逐个删除:
# 删除所有 openclaw 相关的 profile 目录
rm -rf ~/.openclaw
rm -rf ~/.openclaw-*
不确定自己有几个 Profile?运行
ls -la ~ | grep openclaw 看看就知道了。