OpenClaw Windows 标准安装步骤

适用对象

适合第一次安装 OpenClaw，希望按顺序完成安装与基础验证的人。

官方参考

• Getting Started: https://docs.openclaw.ai/start/getting-started
• Install: https://docs.openclaw.ai/install

官方 Windows 快速安装命令：

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

本次采用的安装路线

本机已具备以下前置条件：

• Node.js 22+
• npm
• git

因此本次最终使用：

• Windows 原生 PowerShell 安装 OpenClaw

补充说明

WSL2 / Ubuntu 已作为备用环境保留，但不是本次主安装路径。

安装前检查

先执行：

node --version
npm --version
git --version

本机结果：

• Node.js：v24.12.0
• npm：11.6.2
• git：2.46.2.windows.1

安装 OpenClaw

为了先完成程序安装，再单独处理 onboarding，本次执行：

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

如果你不需要跳过 onboarding，也可以直接执行：

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

安装后补充配置

如果 doctor 提示 gateway.mode 未设置，执行：

openclaw config set gateway.mode local

安装后验证

依次执行：

openclaw --version
openclaw doctor --non-interactive
openclaw status
openclaw dashboard --no-open

本机验证结果：

• openclaw --version 返回 2026.3.7
• openclaw status 显示 Dashboard 地址为 http://127.0.0.1:18789/
• Gateway 可达

Dashboard 正确打开方式

当前机器的正确地址是：

http://127.0.0.1:18789/

不要优先使用：

http://127.0.0.1:18791/

因为本机实测：

• 18789/ 返回 200
• 18791/ 返回 401 Unauthorized

安装完成状态

截至 2026-03-09

– OpenClaw 已安装

– CLI 可用

– Gateway 可启动

– Dashboard 可访问

尚未完成的内容：

• onboarding
• 模型 API Key 配置
• 渠道绑定

分类：OpenClaw