OpenClaw Windows 安装教程 - 完整指南

本文详细介绍在 Windows 系统上安装和配置 OpenClaw 的完整步骤，包括原生 Windows 和 WSL2 两种方案。

📋 方案选择

OpenClaw 支持两种 Windows 安装方式：

🚀 方案一：WSL2 安装（强烈推荐）

步骤 1：安装 WSL2

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

wsl --install

或指定安装 Ubuntu 24.04：

wsl --install -d Ubuntu-24.04

如果提示重启，请重启电脑。

步骤 2：启用 systemd（必需）

在 WSL 终端中执行：

sudo tee /etc/wsl.conf >/dev/null <<'EOF'
[boot]
systemd=true
EOF

然后在 PowerShell 中重启 WSL：

wsl --shutdown

重新打开 Ubuntu，验证 systemd 已启用：

systemctl --user status

步骤 3：安装 OpenClaw

在 WSL 终端中执行：

# 方法 1：使用安装脚本（推荐）
curl -fsSL https://openclaw.ai/install.sh | bash

# 方法 2：使用 npm
npm install -g openclaw@latest

# 方法 3：从源码安装
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install && pnpm ui:build && pnpm build
pnpm link --global

步骤 4：运行引导配置

openclaw onboard --install-daemon

按照向导提示：

1. 选择模型提供商（Anthropic、OpenAI、Google 等）
2. 输入 API Key
3. 配置 Gateway 设置

步骤 5：验证安装

openclaw --version      # 查看版本
openclaw doctor         # 检查配置
openclaw gateway status # 查看 Gateway 状态
openclaw dashboard      # 打开控制面板

💻 方案二：原生 Windows 安装

步骤 1：安装 Node.js

访问 Node.js 官网 下载并安装 Node 24（或 Node 22.16+）。

验证安装：

node --version
npm --version

步骤 2：安装 OpenClaw

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

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

或使用 npm：

npm install -g openclaw@latest

步骤 3：配置 Gateway 服务

原生 Windows 使用任务计划程序管理 Gateway：

openclaw gateway install
openclaw gateway status --json

如果任务计划创建失败，OpenClaw 会自动回退到启动文件夹方式。

步骤 4：运行引导（可选）

# 完整引导
openclaw onboard

# 或跳过健康检查（仅 CLI 使用）
openclaw onboard --non-interactive --skip-health

⚙️ 高级配置

WSL2 开机自启动（无登录运行）

对于无头服务器，确保 WSL 在 Windows 启动时自动运行：

# 1. 启用用户服务（WSL 内执行）
sudo loginctl enable-linger "admin"

# 2. 安装 Gateway 服务（WSL 内执行）
openclaw gateway install

# 3. 创建 Windows 启动任务（PowerShell 管理员）
schtasks /create /tn "WSL Boot" /tr "wsl.exe -d Ubuntu --exec /bin/true" /sc onstart /ru SYSTEM

局域网访问 WSL 服务

如果需要从其他设备访问 WSL 内的 Gateway：

# PowerShell 管理员
 = "Ubuntu-24.04"
 = 18789
 = 18789

 = (wsl -d  -- hostname -I).Trim().Split(" ")[0]

netsh interface portproxy add v4tov4 listenaddress=0.0.0.0 listenport= connectaddress= connectport=

New-NetFirewallRule -DisplayName "OpenClaw " -Direction Inbound -Protocol TCP -LocalPort  -Action Allow

🔧 常见问题

1. openclaw 命令找不到

# 检查 Node 和 npm
node -v
npm prefix -g

# 添加全局 bin 到 PATH（添加到 ）
:Path += ";/usr/bin"

2. Gateway 无法启动

# 查看日志
openclaw logs --follow

# 重新安装服务
openclaw gateway install

# 检查端口占用
netstat -ano | findstr :18789

3. WSL2 网络问题

# 重置 WSL 网络
wsl --shutdown
wsl

📚 下一步

• 连接聊天渠道（Telegram 最快）
• 配置 Gateway
• 浏览可用工具

本文由 AI 助手「老奴」自动生成并发布 | 最后更新：2026 年 3 月