OpenClaw 在 Windows 上的完整安装教程

作者：笃行其道

概述

OpenClaw 推荐在 Windows 上通过 WSL2（Windows Subsystem for Linux 2） 运行，建议使用 Ubuntu 发行版。CLI 和 Gateway 运行在 Linux 环境中，这样可以保持运行时的一致性，并使工具链（Node/Bun/pnpm、Linux 二进制文件、技能包）具有更好的兼容性。
虽然原生 Windows 支持可能会更复杂，但 WSL2 为您提供了完整的 Linux 体验——只需一条命令即可安装。

注意： 原生 Windows 配套应用正在计划中。

---

第一步：安装 WSL2 和 Ubuntu

1.1 快速安装

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

1. wsl --install

复制代码

如果想指定特定的发行版（推荐 Ubuntu 24.04）：

1. # 查看可用发行版
2. wsl --list --online
4. # 安装指定版本
5. wsl --install -d Ubuntu-24.04

复制代码

1.2 重启系统

如果 Windows 提示需要重启，请重启计算机以完成 WSL2 安装。
1.3 首次启动配置

重启后，从开始菜单启动 Ubuntu，系统会要求您：

创建 Linux 用户名设置密码

完成后，您就进入了 Ubuntu 终端环境。

---

第二步：启用 systemd

OpenClaw 的 Gateway 服务需要 systemd 支持。
2.1 配置 WSL

在 Ubuntu 终端中执行：

1. sudotee /etc/wsl.conf >/dev/null <<'EOF'
2. [boot]
3. systemd=true
4. EOF

复制代码

2.2 重启 WSL

回到 Windows PowerShell 执行：

1. wsl --shutdown

复制代码

2.3 验证 systemd

重新打开 Ubuntu 终端，验证 systemd 是否正常运行：

1. systemctl --user status

复制代码

如果看到服务列表输出，说明配置成功。

---

第三步：安装 OpenClaw

3.1 克隆仓库

在 WSL Ubuntu 终端中执行：

1. git clone https://github.com/openclaw/openclaw.git
2. cd openclaw

复制代码

3.2 安装依赖

1. pnpminstall

复制代码

3.3 构建 UI

1. pnpm ui:build  # 首次运行会自动安装 UI 依赖

复制代码

3.4 构建项目

1. pnpm build

复制代码

3.5 初始化配置

1. openclaw onboard

复制代码

按照交互式提示完成初始配置。

---

第四步：安装 Gateway 服务

Gateway 是 OpenClaw 的核心服务组件。有多种安装方式：
方式一：自动安装（推荐）

1. openclaw onboard --install-daemon

复制代码

方式二：直接安装

1. openclaw gateway install

复制代码

方式三：通过配置向导

1. openclaw configure

复制代码

在提示时选择 “Gateway service”。
修复或迁移

如果遇到问题，可以运行诊断工具：

1. openclaw doctor

复制代码

---

高级配置：局域网访问（可选）

为什么需要端口转发？

WSL2 拥有独立的虚拟网络。如果您需要从其他设备访问 WSL 内运行的服务（如 SSH、本地 TTS 服务器或 Gateway），必须将 Windows 端口转发到 WSL 的 IP 地址。
注意： WSL 的 IP 地址在每次重启后会变化，因此可能需要刷新转发规则。
配置端口转发

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

1. # 配置参数$Distro = "Ubuntu-24.04"$ListenPort = 2222  # Windows 监听端口$TargetPort = 22    # WSL 内目标端口# 获取 WSL IP 地址$WslIp = (wsl -d $Distro-- hostname -I).Trim().Split(" ")[0]if(-not$WslIp){throw"无法获取 WSL IP 地址"}# 添加端口转发规则
2. netsh interface portproxy add v4tov4 listenaddress=0.0.0.0 listenport=$ListenPort `
3.   connectaddress=$WslIp connectport=$TargetPort

复制代码

配置防火墙规则（一次性）

1. New-NetFirewallRule-DisplayName "WSL SSH $ListenPort"-Direction Inbound `
2.   -Protocol TCP -LocalPort $ListenPort-Action Allow

复制代码

WSL 重启后刷新转发

每次 WSL 重启后，需要刷新端口转发规则：

1. # 删除旧规则
2. netsh interface portproxy delete v4tov4 listenport=$ListenPort listenaddress=0.0.0.0 |Out-Null# 重新获取 IP 并添加规则$WslIp = (wsl -d $Distro-- hostname -I).Trim().Split(" ")[0]
3. netsh interface portproxy add v4tov4 listenport=$ListenPort listenaddress=0.0.0.0 `
4.   connectaddress=$WslIp connectport=$TargetPort|Out-Null

复制代码

重要提示

局域网访问： 使用 listenaddress=0.0.0.0 允许局域网访问；使用 127.0.0.1 仅限本机访问远程连接示例：ssh user@windows-host -p 2222（使用 Windows 主机的 IP 地址）Gateway 配置： 远程节点必须指向可访问的 Gateway URL（不能是 127.0.0.1），使用 openclaw status --all 确认配置自动化： 可以创建 Windows 计划任务，在登录时自动运行刷新脚本

---

验证安装

检查服务状态

1. openclaw status --all

复制代码

查看 Gateway 状态

1. systemctl --user status openclaw-gateway

复制代码

查看日志

1. journalctl --user -u openclaw-gateway -f

复制代码

---

常见问题

WSL2 安装失败？

确保您的 Windows 版本支持 WSL2（Windows 10 版本 2004 及更高版本，或 Windows 11）。
systemd 无法启动？

检查 /etc/wsl.conf 配置是否正确，并确保执行了 wsl --shutdown。
端口转发不工作？

确认 Windows 防火墙规则已添加检查 WSL IP 地址是否正确：wsl -- hostname -I使用 netsh interface portproxy show all 查看当前转发规则

Gateway 服务无法启动？

运行诊断工具：

1. openclaw doctor

复制代码

---

项目地址：https://github.com/openclaw/openclaw

---

AI 时代的车票正在检票，别等站台空了才后悔。来 AMA 活动，和真正在做事的人聊聊。畅谈AI的同时还能得奖，何乐而不为呢？