先跟大家说清楚，这篇教程是根据 OpenClaw 官方中文手册（https://docs.openclaw.ai/zh-CN）整理的，绝对靠谱！覆盖 Windows、macOS、Linux/WSL2 所有常用系统，不管你是新手还是有点基础，跟着步骤来，安装卸载都能一次成功，所有代码都能直接复制粘贴，不用自己手敲，省事儿～

一、安装前必看（别跳过，不然容易踩坑）

OpenClaw 得靠 Node.js 22 以上版本才能运行，不过大家不用慌！官方的一键安装脚本会自动检测你电脑有没有 Node.js，没有的话会自动安装，完全不用手动操作；但如果是用 npm 安装，就得自己先确认下 Node.js 是不是达标哦。

先检查下 Node.js 版本（复制命令直接执行就行）：

node -v  # Linux/macOS/WSL 终端里输这个
node -v  # Windows 打开 PowerShell 输这个

如果没安装 Node.js，听我的，优先用下面的官方一键脚本，一步到位，比自己装 Node.js 再装 OpenClaw 省事多了！

二、全平台安装方法（3种，选一种最适合你的）

方式1：官方一键脚本安装（最推荐！零配置，新手首选）

这个方法最省心，不管你用什么系统，复制对应命令，执行完就搞定，还会自动帮你装环境、装 CLI，甚至会启动新手引导，手把手教你初始化，对新手太友好了。

Windows 系统（重点：必须用管理员身份打开 PowerShell）

操作步骤：按 Win+X，找到「Windows PowerShell (管理员)」，点进去，然后复制下面的命令，右键粘贴（终端里粘贴是右键，不是Ctrl+V哦），按回车就行。

iwr -useb https://openclaw.ai/install.ps1 | iex

如果不想看新手引导，只想单纯安装 CLI，不做初始化，就用这个命令：

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

macOS / Linux / WSL2（终端直接操作，不用管理员也能装）

打开电脑的终端，直接复制下面的命令，粘贴执行，等待一会儿就安装完成了，特别简单。

curl -fsSL https://openclaw.ai/install.sh | bash

同样，不想看新手引导，就加个参数，命令如下：

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard

方式2：npm 全局安装（适合已经有 Node.js 环境的朋友）

如果你的电脑已经装好了 Node.js（而且版本≥22），不想用一键脚本，那就用 npm 安装，步骤也很简单，全平台通用，复制命令就行。

# 安装最新版 OpenClaw
npm install -g openclaw@latest
# 要是网络慢，就装国内镜像版，速度会快很多
npm install -g openclaw-cn

重点提醒：npm 安装完之后，一定要执行下面这个初始化命令，不然网关守护进程装不上，后续用的时候会出问题！

openclaw onboard --install-daemon

方式3：pnpm/bun 安装（替代 npm，懂的都懂）

如果平时习惯用 pnpm 或者 bun 管理包，也可以用这两个命令安装，和 npm 操作差不多，复制执行就好。

# pnpm 安装
pnpm install -g openclaw@latest
# bun 安装
bun install -g openclaw@latest

安装完一定要验证！确保装成功了

装完别直接关终端，执行下面的命令，能输出版本号，就说明安装成功了；后面两个命令是官方推荐的健康检查，也可以顺便执行下，确认没问题。

openclaw --version  # 查看版本号，有输出就是成功
openclaw doctor     # 健康检查，没问题会提示 OK
openclaw gateway status  # 查看网关状态，确保网关在运行

三、全平台卸载方法（两种方式，按需选择，无残留）

卸载其实很简单，但有个核心前提：不管用哪种方式卸载，先停止并卸载网关服务，不然会有后台进程残留，后续可能删不干净，大家一定要先做这一步！

# 第一步：停止网关服务
openclaw gateway stop
# 第二步：卸载网关服务（不管什么系统，这个命令都能用）
openclaw gateway uninstall

方式1：官方一键卸载（最推荐，全平台通用，省事儿）

这种方式分两种情况，大家按需选：标准卸载（保留配置文件，以后再装还能恢复设置）、彻底卸载（删干净所有数据，不留一点残留）。

# 标准卸载：保留 ~/.openclaw 配置文件夹（推荐，万一以后再装呢）
openclaw uninstall
# 彻底卸载：删除所有配置、数据、服务，一点残留都没有
# 适合不想再用，想彻底清理的朋友，复制直接执行，不用确认
openclaw uninstall --all --yes --non-interactive
# 如果已经卸载了 CLI，输上面的命令没反应，就用这个
npx -y openclaw uninstall --all --yes --non-interactive

方式2：按安装源卸载（你用什么装的，就用什么卸）

如果当初是用 npm、pnpm 或者 bun 安装的，卸载的时候也可以对应着来，步骤也很简单。

# 当初用 npm 装的，就用这个卸
npm uninstall -g openclaw
# 要是装的是国内镜像版，卸这个
npm uninstall -g openclaw-cn

# 当初用 pnpm 装的，就用这个卸
pnpm remove -g openclaw

# 当初用 bun 装的，就用这个卸
bun remove -g openclaw

方式3：手动彻底清理（怕有残留？这样做就对了）

如果还是担心有残留，比如配置文件、二进制文件没删干净，就按系统对应命令，手动清理一遍，确保彻底干净。

macOS / Linux / WSL2 手动清理

# 删除核心配置和数据目录（最关键的残留）
rm -rf ~/.openclaw
# 删除脚本安装留下的二进制文件
sudo rm -f $(which openclaw)
# 清理 systemd 服务残留（有的话就执行，没有也没关系）
sudo systemctl daemon-reload

Windows 手动清理（还是要管理员身份打开 PowerShell）

# 删除用户目录下的所有配置和数据
Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw"
# 删除可能存在的程序安装目录
Remove-Item -Recurse -Force "C:\Program Files\OpenClaw"
# 移除计划任务里的网关残留（避免后台偷偷运行）
schtasks /delete /f /tn "openclaw gateway"

卸载验证：确认真的卸干净了

卸完之后，打开终端（或 PowerShell），输入下面的命令，要是提示「command not found」（Linux/macOS）或者「不是内部或外部命令」（Windows），就说明彻底卸干净了，完美！

openclaw --version
which openclaw  # Linux/macOS 输这个，没有任何输出就是干净了

四、踩坑提醒（我整理的小经验，帮你避坑）

1. Windows 安装/卸载失败：大概率是没开管理员权限！一定要按步骤，用「管理员身份」打开 PowerShell，不然肯定失败。

2. 终端命令不生效：安装完之后，关闭当前终端，重新打开一个再试；或者执行 source \~/\.bashrc（Linux/macOS）、refreshenv（Windows），刷新一下环境变量就好了。

3. 想保留配置：如果以后还想装 OpenClaw，彻底卸载前，先备份一下配置目录，不然里面的 API 密钥、技能配置都会丢，备份命令如下：

# Linux/macOS 备份
cp -r ~/.openclaw ~/.openclaw_backup
# Windows 备份
Copy-Item -Recurse "$env:USERPROFILE\.openclaw" "$env:USERPROFILE\.openclaw_backup"

4. 想查更详细的用法：如果需要进阶操作，比如自定义安装路径、解决异常问题，直接去官方文档看就行，地址：OpenClaw 安装页、OpenClaw 卸载页。