2.2 Windows 系统安装教程（图文版）

概述

一、特别说明：Windows 需要 WSL2

Windows 原生系统不能直接运行 OpenClaw，需要通过 WSL2（Windows Subsystem for Linux 2）。

WSL2 是什么？

> WSL2 是 Windows 内置的 Linux 子系统，可以在 Windows 里同时运行一个完整的 Linux 环境。

简单理解：Linux 是房子的主体，WSL2 是在 Windows 这个大楼里租了一间房。OpenClaw 住在 Linux 这间房里。

二、安装流程总览

Step 1: 确认 Windows 版本
    ↓
Step 2: 安装 WSL2
    ↓
Step 3: 在 WSL2 中安装 Node.js
    ↓
Step 4: 安装 OpenClaw
    ↓
Step 5: 启动 OpenClaw
    ↓
Step 6: 连接飞书渠道（可选）
    ↓
Step 7: 发送第一条消息

三、Step 1：确认 Windows 版本

操作： 1. 按 Win + I 打开设置 2. 点击"系统" 3. 滚动到最底部，点击"关于" 4. 查看"Windows 规格"

要求：

• Windows 11：✅ 直接支持 WSL2
• Windows 10：需要 2004 以上版本（查看"OS 版本" >= 19041）

如果不是 Windows 11 或版本过低：

• 先升级 Windows 到最新版本
• 或联系 IT 管理员

四、Step 2：安装 WSL2

4.1 启用 WSL 功能

操作：

1. 右键点击"开始"菜单 2. 选择"Windows PowerShell（管理员）"或"终端（管理员）" 3. 如果弹出"用户账户控制"，点击"是"

4. 在命令行窗口输入：

wsl --install -d Ubuntu

5. 等待下载和安装完成（需要几分钟，取决于网速）

6. 安装完成后，重启电脑

4.2 首次启动 Ubuntu

重启后，会自动弹出 Ubuntu 终端，如果没有，手动打开：

1. 在任务栏搜索"Ubuntu" 2. 点击打开

4.3 设置 Ubuntu 用户

首次启动会要求设置用户名和密码：

Enter new UNIX username: （输入你的用户名，如 luowen）
New password: （输入密码）
Confirm password: （确认密码）

⚠️ 记住这个用户名和密码，后续会经常用到。

4.4 验证 WSL2 安装成功

在 Ubuntu 终端输入：

wsl --list --verbose

应该看到类似输出：

NAME                   STATE           VERSION
Ubuntu                 Running         2

说明 WSL2 安装成功。

五、Step 3：在 WSL2 中安装 Node.js

5.1 更新 Ubuntu 包列表

在 Ubuntu 终端输入：

sudo apt update && sudo apt upgrade -y

5.2 安装 Node.js 22 LTS

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs

5.3 验证安装

node --version
npm --version

应该看到：

v22.x.x    （Node.js 版本）
10.x.x     （npm 版本）

如果看到错误：检查网络连接，重新运行安装命令。

六、Step 4：安装 OpenClaw

6.1 全局安装 OpenClaw

在 Ubuntu 终端输入：

sudo npm install -g openclaw@latest

⚠️ 注意：这里要用 sudo，否则可能权限不足。

6.2 验证安装

openclaw --version

应该看到类似：

OpenClaw 2026.x.x

6.3 遇到问题？

# 切换到淘宝镜像
sudo npm install -g openclaw@latest --registry=https://registry.npmmirror.com

七、Step 5：启动 OpenClaw

7.1 进入工作目录

cd ~
mkdir -p openclaw-work
cd openclaw-work

7.2 首次引导配置

运行引导命令：

openclaw onboard --install-daemon

你会看到一个交互式界面，按照提示回答问题：

1. 选择语言：选择中文（如果支持）或英文
2. 配置 AI 模型：输入你的 API Key
3. 配置渠道：选择要接入的渠道（飞书/钉钉等）
4. 配置管理员：设置你的身份

每一步都有提示，按回车继续即可。

7.3 启动 Gateway

引导完成后，启动服务：

openclaw gateway start

7.4 验证服务状态

openclaw gateway status

应该看到：

Gateway is running on port 18789

八、Step 6：连接飞书渠道（可选）

如果你想让 AI 在飞书里响应消息，需要配置飞书渠道。

8.1 打开飞书配置

在 Ubuntu 终端输入：

openclaw configure

8.2 在引导界面选择飞书

按照引导步骤，输入飞书机器人的 App ID 和 App Secret。

飞书机器人创建详细步骤，见 2.5 节。

8.3 验证飞书连接

配置完成后，给机器人发一条消息：

你好

如果 AI 回复了，说明飞书渠道配置成功。

九、Step 7：发送第一条消息

方式一：通过飞书发送（如果配置了飞书渠道）

打开飞书，找到你创建的机器人，给它发消息：

你好，测试一下

方式二：通过网页控制台

OpenClaw 自带一个网页界面：

1. 打开浏览器 2. 访问：http://127.0.0.1:18789/ 3. 点击"Chat"开始对话

验证成功的标志

• ✅ AI 回复了你的消息
• ✅ 消息是实时的（不是自动回复）
• ✅ AI 能理解你的问题

十、常见问题