🪟 Windows 部署 OpenClaw 完整指南

OpenClaw 是一个强大的 AI Agent 平台，支持多种 channel（Telegram、Discord、QQ 等）。本文详细介绍在 Windows 环境下的安装配置方法。

📋 目录

• 一、WSL2 安装（推荐）
• 二、原生 Windows 安装
• 三、配置说明
• 四、常见问题 FAQ
• 五、卸载方法

一、WSL2 安装步骤 ⭐推荐

1️⃣ 启用 WSL2

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

# 安装 WSL 和 Ubuntu
wsl --install

# 或指定发行版
wsl --list --online
wsl --install -d Ubuntu-24.04

重启电脑后，打开 Ubuntu 终端。

2️⃣ 启用 systemd（必须）

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

wsl --shutdown

重新打开 Ubuntu，验证：

systemctl --user status

3️⃣ 安装 OpenClaw

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

# 跳过初始化
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard

4️⃣ 运行初始化向导

openclaw onboard

按提示完成：登录云端账号 → 选择 channel → 安装 Gateway 服务

5️⃣ 验证安装

openclaw doctor         # 检查配置
openclaw status         # 查看 Gateway 状态
openclaw dashboard      # 打开浏览器管理界面

二、原生 Windows 安装

1️⃣ 安装 Node.js 22+

# winget（推荐）
winget install OpenJS.NodeJS.LTS

# 或 Chocolatey
choco install nodejs-lts

2️⃣ 安装 Git

winget install Git.Git

3️⃣ 运行安装脚本

# 默认安装
iwr -useb https://openclaw.ai/install.ps1 | iex

# 跳过初始化
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

4️⃣ 配置 PATH

npm prefix -g

将返回的路径添加到系统环境变量 PATH。

三、配置说明

常用环境变量

变量	说明	示例
OPENCLAW_HOME	OpenClaw 主目录	~/.openclaw
OPENCLAW_LOG_LEVEL	日志级别	debug, trace
OPENCLAW_CONFIG_PATH	配置文件路径	~/.openclaw/openclaw.json

四、常见问题 FAQ

❓ Q1: 安装后提示 "openclaw is not recognized"

原因: npm 全局路径未加入 PATH

解决方法: 运行 npm prefix -g，将路径加入系统 PATH。

❓ Q2: Windows 提示 "git not found"

解决方法: 安装 Git for Windows，确保勾选 "Add Git to PATH"。

❓ Q3: WSL2 如何重启 Gateway？

wsl -e bash -c "openclaw gateway restart"

❓ Q4: 如何让 WSL2 服务可被局域网访问？

# PowerShell 管理员执行
$WslIp = (wsl --hostname -I).Trim().Split(" ")[0]
netsh interface portproxy add v4tov4 listenport=8080 connectaddress=$WslIp connectport=8080

❓ Q5: 关闭终端后 Gateway 停止运行？

# 安装为系统服务
openclaw onboard --install-daemon

❓ Q6: sharp 模块安装失败

$env:SHARP_IGNORE_GLOBAL_LIBVIPS = "1"
npm install -g openclaw@latest

五、卸载方法

WSL2/Linux

openclaw uninstall
# 或
rm -rf ~/.openclaw

Windows

npm uninstall -g openclaw
Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw"

📝 总结