OpenClaw 卸载完全指南：2024最新全平台版

彻底移除 OpenClaw 前，建议按以下流程操作。不要直接执行卸载命令，先确保后台进程已终止，并妥善备份配置目录。避免卸载后残留冗余文件，影响系统整洁。

第一步，务必停止 OpenClaw 守护进程。若启用了 Gateway 服务，需手动将其关闭，防止进程占用端口导致后续操作异常。

# 终止守护进程openclaw daemon stop# 或停止 Gateway 服务openclaw gateway stop

即使决定完全移除，仍建议查看现有配置文件。未来重新部署时，这些配置可大幅缩减操作时间。备份路径如下：

• macOS / Linux：~/.openclaw/
• Windows：%USERPROFILE%\.openclaw

完成准备工作后，根据不同操作系统与安装方式，执行以下对应步骤。

Windows（PowerShell安装）

若通过命令行 iwr -useb https://openclaw.ai/install.ps1 | iex 安装，底层逻辑为 npm install -g openclaw，并将 OpenClaw 写入用户 PATH（通常位于 %APPDATA%\npm）。

步骤 1 — 以管理员权限启动 PowerShell，运行 npm 全局卸载：

npm uninstall -g openclaw

步骤 2 — 确认卸载状态：

Get-Command openclaw -ErrorAction SilentlyContinue# 无输出即表示卸载成功

步骤 3 — 彻底清理配置目录与残留文件：

# 删除配置目录Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw"# 若存在 git 安装残留（~/openclaw 目录）一并删除Remove-Item -Recurse -Force "$env:USERPROFILE\openclaw"# 移除 .localbin 中的包装脚本（git 方式安装遗留）Remove-Item -Force "$env:USERPROFILE\.localbin\openclaw.cmd" -ErrorAction SilentlyContinue

Windows（CMD安装）

CMD 安装命令为 curl -fsSL https://openclaw.ai/install.cmd -o install.cmd && install.cmd && del install.cmd。底层同样依赖 npm install -g openclaw，因此卸载流程一致。

步骤 1 — 以管理员身份打开命令提示符，执行卸载：

npm uninstall -g openclaw

步骤 2 — 验证卸载结果：

where openclaw:: 提示"无法找到文件"即表明卸载成功

步骤 3 — 彻底清理残留：

:: 删除配置目录rmdir /s /q "%USERPROFILE%\.openclaw":: 删除 git 源码目录（如存在）rmdir /s /q "%USERPROFILE%\openclaw":: 删除 .localbin 包装脚本del /f "%USERPROFILE%\.localbin\openclaw.cmd"

macOS / Linux 卸载

macOS 与 Linux 安装方式多样。默认安装执行 curl -fsSL https://openclaw.ai/install.sh | bash，核心仍是 npm install -g openclaw。若指定 --install-method git 则从源码拉取。两者卸载步骤有别。

A. 默认 npm 方式卸载

步骤 1 — 运行 npm 全局卸载：

npm uninstall -g openclaw

步骤 2 — 确认命令已从 PATH 移除：

which openclaw# 应无输出或提示"not found"

步骤 3 — 若有残留，手动清理 npm 包目录与软链接：

# 定位 npm 全局包根目录npm root -g# 手动删除残留目录（通常 npm uninstall 已自动清理）rm -rf "$(npm root -g)/openclaw"# 删除 Homebrew 软链接（macOS）rm -f /opt/homebrew/bin/openclaw /usr/local/bin/openclaw

步骤 4 — 最后删除配置目录：

# 主配置目录rm -rf ~/.openclaw# 兼容旧版本遗留目录（可选）rm -rf ~/.clawdbot ~/.moltbot ~/.moldbot

B. Git 源码方式卸载（--install-method git）

使用 --install-method git 安装时，脚本将 OpenClaw 克隆至 ~/openclaw，并在 ~/.local/bin/openclaw 创建包装脚本。卸载时需逆向操作。

步骤 1 — 删除包装脚本：

rm -f ~/.local/bin/openclaw

步骤 2 — 删除源码目录（默认路径 ~/openclaw）：

rm -rf ~/openclaw# 若使用自定义路径，替换相应目录# 例如：rm -rf ~/my-openclaw-src

步骤 3 — 清理 shell 配置文件。安装脚本可能向 ~/.bashrc 或 ~/.zshrc 添加过 PATH 配置，手动删除以下两行：

# 存在则删除export PATH="$HOME/.local/bin:$PATH"export PATH="$HOME/.npm-global/bin:$PATH"

重新加载配置：

source ~/.bashrc # bash 用户source ~/.zshrc# zsh 用户

步骤 4 — 最后删除配置目录：

rm -rf ~/.openclaw

npm 全局安装卸载

此方式最为简洁，安装命令为 npm i -g openclaw，随后执行 openclaw onboard。卸载同样一条命令解决。

步骤 1 — 执行 npm 全局卸载：

npm uninstall -g openclaw

步骤 2 — 验证卸载结果：

# macOS / Linuxwhich openclaw# 应无输出npm list -g openclaw --depth=0 # 应显示 "(empty)" 或报错

# Windowswhere openclaw # 应提示"无法找到"

步骤 3 — 可选删除配置目录：

# macOS / Linuxrm -rf ~/.openclaw

# Windows PowerShellRemove-Item -Recurse -Force "$env:USERPROFILE\.openclaw"

pnpm 全局安装卸载

若使用 pnpm，安装命令为 pnpm add -g openclaw，随后 openclaw onboard。pnpm 将全局包存放于其存储目录（通常为 ~/.local/share/pnpm），具体位置可通过 pnpm root -g 查看。

步骤 1 — 执行 pnpm 全局卸载：

pnpm remove -g openclaw# 或使用 rm 别名pnpm rm -g openclaw

步骤 2 — 确认已移除：

# macOS / Linuxwhich openclaw# 应无输出pnpm list -g# openclaw 应不在列表中

# Windows PowerShellpnpm list -g# openclaw 应不在列表中

步骤 3 — 若缓存未清干净，手动处理 pnpm 存储目录：

# 查看 pnpm 全局包根目录pnpm root -g# 手动清理（通常 pnpm remove 已处理）rm -rf "$(pnpm root -g)/openclaw"# 清理 pnpm 全局 bin（如有残留链接）rm -f "$(dirname $(pnpm root -g))/bin/openclaw"

步骤 4 — 最后删除配置目录：

# macOS / Linuxrm -rf ~/.openclaw

# Windows PowerShellRemove-Item -Recurse -Force "$env:USERPROFILE\.openclaw"

卸载方式汇总对照表