【五】Windows环境下安装OpenClaw

在 Windows 下安装 OpenClaw，官方推荐两种方式：一键脚本安装（原生 Windows，最简单）和WSL2 安装（兼容性更好，推荐进阶用户）。以下是详细步骤：

方式一：一键脚本安装（原生 Windows，推荐新手）

1. 准备工作

• 系统：Windows 10/11 64位
• 权限：管理员身份运行 PowerShell
• 网络：正常联网

2. 执行安装

1. 以管理员身份打开 PowerShell
   • Win+X → 选择终端(管理员)或Windows PowerShell (管理员)
2. （可选，防报错）临时解除执行策略

   Set-ExecutionPolicyBypass-ScopeProcess-Force

3. 运行官方一键安装脚本

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

   • 网络慢可换国内镜像：

     iwr-useb https://clawd.org.cn/install.ps1|iex

4. 按提示完成初始化（onboarding）
   • 登录 AI 服务商（OpenAI / Claude / 智谱等）
   • 设置权限、路径等

3. 验证安装

openclaw--version openclaw gateway# 启动服务

浏览器访问：http://localhost:8888

方式二：WSL2 安装（官方强烈推荐，稳定兼容）

1. 安装 WSL2（管理员 PowerShell）

wsl--install

• 自动安装 Ubuntu，重启电脑
• 重启后设置 Ubuntu 用户名、密码

2. 在 WSL Ubuntu 中安装

curl-fsSLhttps://openclaw.ai/install.sh|bash

• 按提示完成初始化
• 启动：

  openclaw gateway

• Windows 浏览器访问：http://localhost:8888

方式三：手动安装（已装 Node）

1. 安装 Node.js 22+/24+

• 下载：https://nodejs.org/
• 安装时勾选Add to PATH
• 验证：

  node-v npm-v

2. 全局安装 OpenClaw

npm install-g openclaw@latest

3. 初始化 & 启动

openclaw onboard# 配置引导openclaw gateway# 启动服务

常见问题

1. 脚本无法运行
   • 必须管理员 PowerShell
   • 先执行：Set-ExecutionPolicy RemoteSigned -Force
2. Node 版本过低
   • 卸载旧版，安装 Node 22+/24+
3. 启动失败 / 端口占用
   • 关闭占用 8888 端口的程序
   • 或指定端口：openclaw gateway --port 8889
4. 依赖报错
   • Windows 原生：安装 Visual C++ 运行库
   • WSL：sudo apt update && sudo apt install build-essential

启动与使用

• 启动服务：openclaw gateway
• 访问面板：http://localhost:8888
• 查看帮助：openclaw --help

安装成功的完整截图

重启powershell，再运行以下命令

openclaw-cn onboard openclaw onboard

配置本地信息

其他配置大家可依据后续图示配置

本地启动Gateway

Web端页面

至此Windows下的openclaw的配置就已经完成了。