AI创想

标题: OpenClaw 在 Windows 上的完整安装教程 [打印本页]
作者: 米落枫    时间: 8 小时前
标题: OpenClaw 在 Windows 上的完整安装教程
作者：笃行其道
(, 下载次数: 0)


概述

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，系统会要求您：
完成后，您就进入了 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
复制代码
重要提示

验证安装

检查服务状态
  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。
端口转发不工作？

Gateway 服务无法启动？

运行诊断工具：
  1. openclaw doctor
复制代码
项目地址：https://github.com/openclaw/openclaw
(, 下载次数: 0)


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



欢迎光临 AI创想 (https://llms-ai.com/) Powered by Discuz! X3.4