🔧 Step 0：先配置消息接收渠道

⚠️ 本案例需要发送通知到你的手机，先配置消息渠道 👉 去配置 Telegram/飞书/微信接入 →

直接复制这段：WSL2 安装 + 开启 systemd

PowerShell（管理员）运行：

wsl --install
# 重启电脑后打开 Ubuntu，设置用户名密码

Ubuntu 终端运行（开启 systemd）：

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

PowerShell 重启 WSL：

wsl --shutdown

为什么用 WSL2？

OpenClaw 官方推荐在 Windows 上使用 WSL2（Linux 子系统）。WSL2 提供完整的 Linux 环境，工具兼容性好，避免 Windows 原生路径的各种问题。

完整安装流程

第一步：安装 WSL2 + Ubuntu

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

# 安装 WSL2（默认安装 Ubuntu）
wsl --install

# 或指定版本
wsl --install -d Ubuntu-24.04

安装完成后重启电脑。

重启后打开 Ubuntu，设置用户名和密码，等待初始化完成。

第二步：在 WSL2 里开启 systemd（必须）

在 Ubuntu 终端里运行：

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

然后在 PowerShell 里重启 WSL：

wsl --shutdown

重新打开 Ubuntu，验证 systemd 正常：

systemctl --user status

第三步：安装 Node.js 22

在 Ubuntu 终端里：

# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc

# 安装 Node.js 22
nvm install 22 && nvm use 22
node -v  # 应显示 v22.x.x

第四步：安装 OpenClaw

curl -fsSL https://openclaw.ai/install.sh | bash
# 或
npm install -g openclaw@latest

第五步：运行引导向导

openclaw onboard --install-daemon

向导会引导你：

选择 AI 模型（推荐千问或硅基流动，国内不需要梯子）
配置渠道（Telegram / 飞书）
安装系统服务（WSL2 使用 systemd）

第六步：设置开机自启（可选）

如果想让 OpenClaw 随 Windows 开机自动启动（不需要手动打开 WSL）：

在 WSL 里：

# 让用户服务在无登录时也能运行
sudo loginctl enable-linger "$(whoami)"

# 安装 Gateway 系统服务
openclaw gateway install

在 PowerShell（管理员）里：

# 让 WSL 在 Windows 启动时自动运行
schtasks /create /tn "WSL Boot" /tr "wsl.exe -d Ubuntu --exec /bin/true" /sc onstart /ru SYSTEM

验证安装成功

openclaw gateway status   # Gateway 运行中
openclaw health           # 整体健康检查

配置国产模型（不需要梯子）

千问（阿里云）

注册阿里云百炼，获取 API Key。

在 ~/.openclaw/openclaw.json 中配置：

{
  "env": {
    "OPENAI_API_KEY": "sk-xxx",
    "OPENAI_BASE_URL": "https://dashscope.aliyuncs.com/compatible-mode/v1"
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "openai/qwen-plus"
      }
    }
  }
}

硅基流动（多模型聚合，新用户有免费额度）

注册硅基流动，获取 API Key。

{
  "env": {
    "OPENAI_API_KEY": "sk-xxx",
    "OPENAI_BASE_URL": "https://api.siliconflow.cn/v1"
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "openai/deepseek-ai/DeepSeek-V3"
      }
    }
  }
}

配置后重启：

openclaw gateway restart

常见问题

PowerShell 执行策略限制

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

查看 WSL 里的 openclaw 日志

openclaw logs --follow

WSL 里找不到 openclaw 命令

# 确认 npm 全局路径在 PATH 里
echo $PATH
# 如果没有，添加：
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

管理命令

openclaw gateway status     # 查看状态
openclaw gateway restart    # 重启
openclaw logs --follow      # 实时日志
openclaw health             # 健康检查
npm install -g openclaw@latest  # 更新

注意事项

WSL2 内的 OpenClaw 监听 127.0.0.1:18789，Windows 浏览器可以直接访问
开机自启需要同时设置 loginctl enable-linger + WSL 开机任务
国内推荐千问或硅基流动，不需要梯子，稳定可靠
Node.js 必须 22+，nvm install 22 是最安全的方式

Windows 部署 OpenClaw：WSL2 完整流程