OpenClaw Uninstall

如何卸载 OpenClaw CLI、npm 和全局安装

分步指南：彻底卸载 OpenClaw CLI、npm 全局包、shell profile 变更和命令行残留，支持 macOS、Windows 和 Linux。
2026/03/13

第一步：打开终端

  • Mac —— 按 Command + Space（空格键），输入 Terminal 或 终端，按回车。
  • Windows —— 按 Win + R，输入 cmd 按回车；或在开始菜单搜索 PowerShell。
  • Linux —— 打开你的终端，或按 Ctrl + Alt + T。

第二步：快速卸载（CLI 仍可用）

如果 openclaw 命令还能用，运行：

openclaw uninstall --all --yes
  • uninstall：告诉程序「我要卸载」。
  • --all：彻底删除，包括网关服务、本地数据库、配置文件等所有数据。
  • --yes：全程自动确认，不需要手动按 Y。

完全无交互模式（脚本/CI/npx）：

openclaw uninstall --all --yes --non-interactive
npx -y openclaw uninstall --all --yes --non-interactive

这一步会一次性完成网关停止、服务卸载、状态和配置删除。

第三步：删除 CLI 全局包

上面的指令跑完后，电脑里只剩 OpenClaw 的外壳（CLI 工具）。用你当初安装时的包管理器删除它：

npm rm -g openclaw
# 或者
pnpm remove -g openclaw
# 或者
bun remove -g openclaw

验证已删除：

which openclaw       # macOS/Linux —— 应该没有返回
where.exe openclaw   # Windows —— 应该没有返回

第四步：手动网关操作（如果跳过了第二步）

如果你想逐步操作而非一键 openclaw uninstall --all：

openclaw gateway stop
openclaw gateway uninstall

然后删除状态和配置：

rm -rf "${OPENCLAW_STATE_DIR:-$HOME/.openclaw}"
rm -rf ~/.openclaw/workspace

Windows（PowerShell）：

Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw"

第五步：清理 shell 配置

检查 OpenClaw 是否往你的 shell 配置里加过东西：

  • ~/.zshrc、~/.zprofile（macOS）
  • ~/.bashrc、~/.bash_profile、~/.profile（Linux）
  • PowerShell $PROFILE（Windows）

移除所有：

  • OPENCLAW_* 环境变量
  • 指向 OpenClaw 的 PATH 条目
  • 引用 OpenClaw 脚本的 source 行
  • 封装 openclaw 命令的 alias

第六步：源码安装清理（git clone）

如果你是通过 git clone 运行的 OpenClaw（而非全局 npm 安装）：

  1. 先卸载网关服务（用第二步或第四步的方法），再删除 repo。
  2. 删除 repo 目录。
  3. 按上述方法删除状态 + 工作区。

第七步：验证清理干净

运行以下命令确认没有残留：

macOS / Linux：

which openclaw
npm ls -g openclaw
ls ~/.openclaw 2>/dev/null

Windows（PowerShell）：

where.exe openclaw
npm ls -g openclaw
Test-Path "$env:USERPROFILE\.openclaw"

所有命令都应该返回空或"未找到"。

注意事项

  • 建议重启 —— 清理完成后重启电脑，确保所有后台进程彻底关闭。
  • 废弃旧 API Key —— 如果你在 OpenClaw 里绑定过 API Key（如 OpenAI、Claude 的密钥），强烈建议去对应官网废弃旧 Key，生成新的 Key，以防万一。
  • Profile —— 如果你用过 --profile 或 OPENCLAW_PROFILE，对每个 profile 目录重复状态删除（如 ~/.openclaw-<profile>）。
  • 自定义配置路径 —— 如果你把 OPENCLAW_CONFIG_PATH 设到了状态目录以外的位置，也需要手动删除那个文件。
如何卸载 OpenClaw CLI、npm 和全局安装