OpenClaw 安装与删除全流程方案（Windows 篇）

一、先搞清楚：Windows 上有两条安装路线

路线 A：WSL2 安装（推荐）

如果你希望 OpenClaw 的 CLI、Gateway、工具链兼容性更完整，优先选 WSL2。官方 Windows 平台页明确把 WSL2 标成 recommended，并说明完整体验更适合在 Linux 环境里运行。

路线 B：原生 Windows 安装

如果你只是想先把 OpenClaw 跑起来，做本机 CLI、Gateway、基础配置和测试，原生 Windows 也能用。官方写明，原生 Windows 现在已经支持安装脚本 install.ps1、常见 CLI 命令、doctor、插件列表，以及本地 agent/provider 的 smoke test。

我的建议很直接：

• 想长期稳定使用：选 WSL2
• 想先快速试跑：可先用原生 Windows
• 后面要正式常驻部署：仍建议迁到 WSL2

二、安装前的环境要求

OpenClaw 当前要求 Node 22.14 或更高版本，其中 Node 24 是默认且推荐的版本。如果你使用官方安装脚本，Node 会自动检测并安装；如果你自行管理环境，也可以手动装 Node。

在 Windows 上，如果你要手动装 Node，官方 Node 文档给出的推荐方式是：

winget install OpenJS.NodeJS.LTS

也可以用 Chocolatey：

choco install nodejs-lts

或者直接下载 Node 官方安装包。

安装完成后先检查版本：

node -v

如果输出是 v24.x.x，说明是推荐版本；如果是 v22.14.x 或更高，也在支持范围内。

三、Windows 最推荐的安装方式：官方安装脚本

OpenClaw 官方当前给 Windows 的主线安装命令是 PowerShell 脚本：

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

这个脚本会自动识别系统、在需要时安装 Node、安装 OpenClaw，并启动 onboarding 初始化流程。

如果你只想先安装，不想立刻进入初始化引导，官方提供了 -NoOnboard 方式：

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

这适合你先把程序装好，再自己决定什么时候开始配置。

四、如果你更习惯自己控环境：手动安装也可以

如果你已经自己装好了 Node，可以直接全局安装 OpenClaw。官方安装文档给出的方式如下：

npm 方式

npm install -g openclaw@latest
openclaw onboard --install-daemon

pnpm 方式

pnpm add -g openclaw@latest
pnpm approve-builds -g
openclaw onboard --install-daemon

需要注意，官方明确说明：pnpm 需要额外执行 pnpm approve-builds -g，因为有带构建脚本的包需要显式批准。

如果你是开发者，也可以从源码跑：

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build
pnpm build
pnpm link --global
openclaw onboard --install-daemon

这条路线更适合调试和二次开发，不适合普通用户第一次安装。

五、WSL2 路线怎么装

如果你走 WSL2，官方建议就是在 WSL 里按 Linux 路径安装 OpenClaw。Windows 平台页明确写了：WSL2 是推荐路径，而安装页也把 WSL2 归到与 macOS/Linux 相同的安装脚本路线。

在 WSL2 里执行：

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

如果不想立刻 onboarding：

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

安装完成后再执行：

openclaw onboard --install-daemon

这就是官方推荐的 WSL2 主线。

六、初始化：安装完不等于能用

很多人装完 CLI 就以为结束了，其实 真正让 OpenClaw 可用的是 onboarding。官方安装文档和 Windows 平台文档都把 openclaw onboard --install-daemon 作为标准初始化入口；它会继续配置 Gateway 服务和本地运行所需的内容。

标准命令：

openclaw onboard --install-daemon

如果你在 原生 Windows 上不想安装 Gateway 托管服务，只想跑 CLI，本地临时使用，官方给了两个方式：

openclaw onboard --non-interactive --skip-health
openclaw gateway run

如果你想要托管启动，则用：

openclaw gateway install
openclaw gateway status --json

官方说明，在原生 Windows 下，gateway install 会优先尝试 Windows Scheduled Tasks；如果任务创建被阻止，OpenClaw 会回退到当前用户 Startup 文件夹登录项，并在登录后自动启动。

七、安装成功后，一定要做这 4 个验证

OpenClaw 官方安装文档给出的标准验证动作有三个：检查版本、运行 doctor、检查 gateway status。CLI/Gateway 文档还给了更细的健康检查命令。

1）检查 CLI 是否可用

openclaw --version

2）检查配置和迁移问题

openclaw doctor

3）检查 Gateway 状态

openclaw gateway status

4）需要更严格时，直接检查 Gateway 健康

openclaw gateway health --url ws://127.0.0.1:18789

官方 CLI 文档说明，Gateway 默认通常跑在 18789 端口；gateway status 看的是服务层和可选 RPC 探测，而 gateway health 更适合直接验证 Gateway 是否真的活着。

八、Windows 下的日常管理命令

装好以后，最常用的是这一组：

openclaw gateway install
openclaw gateway start
openclaw gateway stop
openclaw gateway restart
openclaw gateway uninstall
openclaw logs --follow

这些命令都是官方 CLI 参考里的标准子命令。其中 gateway status、install、stop、restart、uninstall 都支持脚本化使用；logs --follow 则适合持续追日志。

九、删除 OpenClaw：最省事的方式

如果你只是想把 OpenClaw 从 Windows 上卸掉，官方最推荐的方式不是手工删文件，而是直接用内置卸载命令：

openclaw uninstall

如果你想非交互式地自动删除：

openclaw uninstall --all --yes --non-interactive

或者：

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

官方 CLI 文档还建议，如果你怕删错，可以先备份：

openclaw backup create
openclaw uninstall

内置卸载器会卸掉 Gateway 服务和本地数据，但 CLI 本身默认保留。

十、手动彻底删除：适合想清干净的人

如果你想把 OpenClaw 尽量删干净，可以按官方卸载页给出的手动顺序来做。

第一步：停止 Gateway

openclaw gateway stop

第二步：卸载 Gateway 服务

openclaw gateway uninstall

第三步：删除状态目录和配置

官方默认状态目录是 ~/.openclaw；如果你用了 profile，则是 ~/.openclaw-<profile>。

在 Windows PowerShell 里你可以这样删：

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

如果你还设置过 OPENCLAW_CONFIG_PATH，并且配置文件放在状态目录以外，那个文件也要一并删除。

第四步：删除工作区（可选）

官方默认工作区路径写的是 ~/.openclaw/workspace。如果你也要清理 agent 文件，可以一起删：

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

第五步：删除 CLI

如果你当初是 npm 安装：

npm rm -g openclaw

如果是 pnpm：

pnpm remove -g openclaw

如果是 bun：

bun remove -g openclaw

这些都是官方卸载页给出的标准移除方式。

十一、如果 CLI 已经没了，但后台还在跑，怎么删残留

这是 Windows 上最容易让人困惑的情况：openclaw 命令已经不可用，但 Gateway 还在系统里常驻启动。官方卸载页专门给了 Windows 的手工移除方法。

默认情况下，Windows 的任务名称是：

• OpenClaw Gateway
• 或 OpenClaw Gateway (<profile>)

手工删除 Scheduled Task：

schtasks /Delete /F /TN "OpenClaw Gateway"

然后删除任务脚本：

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

如果你用了 profile，就删对应的任务名，以及 ~.openclaw-<profile>\gateway.cmd。

十二、WSL2 下想实现"Windows 开机就自动跑"，怎么做

如果你是 WSL2 用户，而且希望 Windows 还没登录时，OpenClaw 就能跟着系统起来，官方 Windows 平台页给了完整启动链。

1）先在 WSL 里保持用户服务可运行

sudo loginctl enable-linger "$(whoami)"

2）在 WSL 里安装 OpenClaw Gateway 服务

openclaw gateway install

3）在 Windows 里创建开机触发 WSL 的任务

官方明确要求这一步在 PowerShell 管理员模式 下执行：

schtasks /create /tn "WSL Boot" /tr "wsl.exe -d Ubuntu --exec /bin/true" /sc onstart /ru SYSTEM

其中 Ubuntu 要替换成你自己的发行版名称，可以先查：

wsl --list --verbose

4）重启后在 WSL 内验证

systemctl --user is-enabled openclaw-gateway
systemctl --user status openclaw-gateway --no-pager

这套链路是官方推荐给 headless 场景的 Windows 启动方式。

十三、最常见的两个问题

1）安装成功，但提示 openclaw: command not found

官方 Node 安装文档明确说，这种情况大多数都是 npm 全局安装目录没进 PATH。排查顺序如下：

npm prefix -g

然后确认这个目录是否已经在系统 PATH 里。Windows 下，官方建议把 npm prefix -g 的输出路径加入：

设置 → 系统 → 环境变量 → PATH。

2）原生 Windows 上安装托管服务失败

这不一定是 OpenClaw 本身坏了。官方说明，原生 Windows 上 openclaw gateway install 会优先使用 Scheduled Tasks；如果任务创建被系统策略拦截，它会退回到当前用户 Startup 文件夹的自动启动模式。也就是说，创建计划任务失败，不代表 OpenClaw 完全无法用。

十四、给 Windows 用户的最终建议

如果你是第一次在 Windows 上接触 OpenClaw，我建议直接这么做：

1. 优先选 WSL2
2. 用官方脚本安装
3. 执行 openclaw onboard --install-daemon
4. 用 openclaw --version、openclaw doctor、openclaw gateway status 做验证
5. 以后需要删除时，优先用 openclaw uninstall
6. 真的要删干净，再补手工清理 Scheduled Task、状态目录和 CLI

这样做的好处是：安装路径清晰、删除路径也清晰，后面排错不会乱。 这也是目前最符合 OpenClaw 官方文档的 Windows 使用方式。