Windows 最详细 OpenClaw 部署指南

WSL2 + Ubuntu 22+ + 飞书接入｜国内可用

📌 阅读指南

本文面向零基础 Windows 用户，手把手在 Windows 上部署 OpenClaw，并接入飞书作为消息平台（国内直连，无需代理）。

✅ 重要结论

OpenClaw 核心运行在 Linux/macOS 上，Windows 通过 WSL2（Windows Subsystem for Linux）运行，体验与实体 Ubuntu 完全一致。

本文使用飞书作为入口，国内网络直连，无需翻墙。

Node.js 版本要求：≥ 22.14.0（OpenClaw 2026.4+ 的硬性要求）

🅰️ 第一阶段：开启 WSL2

1 检查 Windows 版本

按 Win + R，输入 winver 查看版本。WSL2 需要 Windows 10 2004 版及以上或 Windows 11。

如果版本低于要求：设置 → Windows Update 升级。

2 开启虚拟机平台

以管理员身份打开 PowerShell，执行：

dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

或通过控制面板：程序 → 启用或关闭 Windows 功能 → 勾选☑️ 适用于 Linux 的 Windows 子系统 + ☑️ 虚拟机平台 → 确定 → 重启电脑。

⚠️ 必须重启电脑

开启虚拟机平台后一定要重启，否则 WSL2 无法正常工作。

3 安装 WSL2 Ubuntu

重启后，以管理员身份打开 PowerShell，执行：

wsl --install

💡 如果上面命令报错，试试分步执行：

wsl --set-default-version 2

wsl --install -d Ubuntu-22.04

安装完成后，按提示设置 Ubuntu 的用户名和密码（用户名建议英文，密码不会显示在屏幕上，正常现象）。

✅ 验证 WSL2 安装成功

wsl -l -v

看到 Ubuntu-22.04 后面是 VERSION 2 即成功。

4 WSL2 换国内源（必做）

默认 Ubuntu 源在国内极慢，换阿里云源：

sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak# 替换为阿里云源（Ubuntu 22.04 Jammy）sudo bash -c 'cat > /etc/apt/sources.list << 'EOF'' deb https://mirrors.aliyun.com/ubuntu/ jammy main restricted universe multiverse deb https://mirrors.aliyun.com/ubuntu/ jammy-updates main restricted universe multiverse deb https://mirrors.aliyun.com/ubuntu/ jammy-security main restricted universe multiverse deb https://mirrors.aliyun.com/ubuntu/ jammy-backports main restricted universe multiverse EOF'# 更新软件包sudo apt update && sudo apt upgrade -y

5 安装 Node.js 22+

⚠️ 版本要求：Node.js ≥ 22.14.0

OpenClaw 2026.4+ 必须使用 Node.js 22.14.0 及以上，20.x 版本无法运行。

# 安装 Node.js 22.x（适用于 Ubuntu 22.04）

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash -sudo apt-get install -y nodejs# 验证安装（必须显示 v22.x.x）node --version   # 必须 ≥ v22.14.0npm --version

6 npm 换国内镜像（必做）

# 切换为阿里云 npm 镜像sudo npm config set registry https://registry.npmmirror.com# 确认npm config get registry# 应返回 https://registry.npmmirror.com

🅱️ 第二阶段：安装 OpenClaw

7 安装 OpenClaw

# 全局安装 OpenClawsudo npm install -g openclaw# 验证版本openclaw --version# 应显示 OpenClaw 2026.4.5 或更高

💡 如果安装卡住

多等几分钟，或重试。国内网络不稳定属正常现象。

sudo npm install -g openclaw --registry https://registry.npmmirror.com --prefer-online

8 初始化配置

openclaw onboard

交互式引导，按提示操作。关键步骤：

步骤	说明	建议
Gateway 端口	默认 18789	直接回车默认
绑定方式	loopback / 0.0.0.0	选 loopback（安全）
飞书接入	先跳过，后面手动配置	选 skip
AI 模型	先跳过，后面手动配置	选 skip

11 创建开机自启任务

WSL2 里不用 systemd，用 Windows 任务计划程序实现开机自启。

# 先查看 Ubuntu 安装名称wsl -l -v

在管理员 PowerShell中执行（把 Ubuntu-22.04 换成你实际的名称）：

# 删除旧任务（如果有）Unregister-ScheduledTask -TaskName OpenClawGateway -Confirm:$false -ErrorAction SilentlyContinue# 创建开机自启任务$action = New-ScheduledTaskAction -Execute "wsl.exe" -Argument "-d Ubuntu-22.04 -e bash -c 'openclaw gateway start'"$trigger = New-ScheduledTaskTrigger -AtStartup$settings = New-ScheduledTaskSettingsSet -AllowStartIfOnBatteries -DontStopIfGoingOnBatteries -StartWhenAvailable  Register-ScheduledTask -TaskName "OpenClawGateway" -Action $action -Trigger $trigger -Settings $settings -Description "OpenClaw Gateway 自动启动" | Out-Null# 验证Get-ScheduledTask -TaskName OpenClawGateway | Select TaskName, State

✅ 验证自启

重启电脑，然后检查任务状态：

Get-ScheduledTask -TaskName OpenClawGateway | Select TaskName, State

State 应为 Ready。

13 配置飞书权限

在飞书开放平台，进入应用 → 权限管理，开通以下权限：

权限名称	权限标识	用途
接收消息	im:message	接收用户消息
发送消息	im:message:send_as_bot	发送回复
读取消息	im:message.receive_v1	获取消息内容

权限审核通常自动通过（自建应用无需企业认证）。

15 在 OpenClaw 中配置飞书

编辑配置文件：

nano ~/.openclaw/openclaw.json找到或添加 channels.feishu 部分："channels": {   "feishu": {     "enabled": true,     "appId": "cli_你的AppID",     "appSecret": "你的AppSecret",     "botName": "AI助手"   } }

⚠️ 注意：先启动 gateway 获取回调地址

飞书需要配置回调 URL（公网可达），此时 gateway 在 WSL2 里没有公网 IP。有两个解决方案，见下方「网络打通」步骤。

17 重启 Gateway 并完成飞书回调配置

网络隧道建立后，重启 gateway：

openclaw gateway restart

然后将 cpolar 返回的公网 URL（带 /feishu/callback）填入飞书开放平台的「事件与回调 → 请求地址 URL」。

✅ 验证飞书接入成功

在飞书中找到你的自建应用 Bot，给它发一条消息。

如果 Bot 回复了，说明接入成功！

合计约1-1.5小时

原创内容 · 欢迎转载