Windows 安装 OpenClaw 保姆级教程(2026最新,可直接复制)

一、系统要求（必看）

- Windows 10/11 64位
​
- 内存 ≥ 8GB（推荐16GB）
​
- 磁盘剩余 ≥ 10GB
​
- 网络正常（国内建议用加速源）

方案A：一键脚本安装（新手首选，全程自动）

1. 打开管理员PowerShell（关键）

1. Win+X → 选择 Windows 终端(管理员) 或 Windows PowerShell(管理员)
​
2. 弹出“用户账户控制” → 点 是

2. 先解决权限问题（必做）

复制粘贴执行：
powershell
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force,回车执行
提示“是否更改执行策略” → 输入 Y 回车

3. 执行一键安装（国内加速版，最稳）

复制粘贴执行（全程自动，3-8分钟，别关窗口）：
powershell
iwr -useb https://open-claw.org.cn/install-cn.ps1 | iex按回车执行
- 脚本自动：检测环境→安装Node.js 22+→下载OpenClaw→配置环境变量
​
- 出现 OpenClaw installed successfully → 安装完成

4. 验证安装（必做）
powershell
 openclaw --version
openclaw help按回车执行
显示版本号（如v0.1.xx）→ 成功
方案B：手动安装（适合进阶/脚本失败时）
1. 安装必备依赖
1.1 安装 Node.js 22+（必须）
- 下载：https://nodejs.org/ → 选 LTS 22.x → Windows Installer 64位
- 安装：一路Next，勾选 Add to PATH
- 验证：新开PowerShell，执行
node -v # 应≥22.0.0
npm -v

1.2 安装 Git（推荐）

- 下载：https://git-scm.com/ → Windows 64位
​
- 安装：默认选项，勾选 Add to PATH

2. 全局安装 OpenClaw
powershell
 npm install -g openclaw --registry=https://registry.npmmirror.com

- 等待完成 → 执行  openclaw --version  验证

三、首次配置（必做，否则无法使用）

1. 启动配置向导
powershell
 openclaw onboard

按提示选择：

1.安装模式：quickstart（快速开始）
​
2. AI模型：新手选 OpenAI GPT 或 DeepSeek（国内选DeepSeek更稳）
​
3. 输入你的 API Key（提前准备好）
​
4.完成后自动安装守护进程（后台运行）

启动网关服务（Web控制台）
powershell
openclaw gateway run

访问：http://127.0.0.1:18789 → 进入OpenClaw控制台
​
停止：Ctrl+C

 

四、常见问题与解决

1. 安装报错/权限不足

- 确保用管理员PowerShell
​
- 重新执行权限命令： Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force 
​
- 清理缓存重装：
powershell
npm uninstall -g openclaw
npm cache clean --force
npm install -g openclaw --registry=https://registry.npmmirror.com

2. 国内网络慢/下载失败

- 用国内加速脚本： iwr -useb https://open-claw.org.cn/install-cn.ps1 | iex 
​
- 或手动指定镜像安装

3. 启动失败/端口占用

- 关闭占用18789端口的程序，或改端口：
powershell
 openclaw gateway run --port 18790

五、常用命令（收藏）

- 查看版本： openclaw --version 
​
- 启动网关： openclaw gateway run 
​
- 后台守护： openclaw daemon start 
​
- 停止守护： openclaw daemon stop 
​
- 重启服务： openclaw gateway restart 
​
- 查看帮助： openclaw help

学习更多的Ai知识，请关注；不会不懂得也可以私信我