🔧 手动分步卸载

当一键卸载不可用时(比如 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 看看就知道了。