资料核对日期:2026-11-16;未做本地安装实测。本文适用于 Windows 上已经具备 WSL2 Linux 终端的用户,并固定采用 WSL2 命令行路线完成 OpenClaw 安装与验收。

路线与准备条件

本路线把 Gateway 运行在 WSL2 内,不涉及 Windows Hub、Tauri 或原生 PowerShell 安装。OpenClaw 官方当前支持 WSL2 Gateway,但给定文档没有说明 Windows 侧启用 WSL2 的版本门槛与安装命令,因此这些信息待确认。开始前应确保能够正常进入 WSL2 Linux 终端,并可访问安装地址。

OpenClaw 当前要求 Node.js 24.16.0 以上的 24.x,或 26.1.0 以上版本;官方更推荐 Node 26,并建议使用包含安全修复的 24.22.1 以上或 26.12.1 以上版本。可先检查:

node --version

Linux 环境缺少 Node 时,官方安装器会配置 Node 24 LTS。引导还需要已有的 Claude Code 或 Codex CLI 登录,或者真实可用的模型提供商 API 密钥。不要把文档中的密钥占位符当作实际配置值。

在 WSL2 中安装

打开 WSL2 Linux 终端,逐字运行官方的 macOS、Linux、WSL2 安装命令:

curl -fsSL https://openclaw.ai/install.sh | bash

安装器会检测系统、安装 OpenClaw,并自动启动引导。已有可复用的模型访问方式时,可选择 Quick start;需要逐项配置时选择 Custom setup。按引导完成登录或输入真实 API 密钥。预期结果是认证通过、配置保存,并打开 Web Dashboard;如果没有检测到可用认证方式,引导会进入手动提供商设置。

让 Gateway 持续运行

Quick start 询问是否让 OpenClaw 在后台持续运行时,选择同意即可安装后台服务。若当时没有安装服务,先结束前台 Gateway,再依次运行:

openclaw gateway install
openclaw gateway start

在 WSL2 中,这会使用 systemd 用户服务。第一条命令注册服务后可能仍在启动;第二条命令会等待 Gateway 通过健康与就绪检查。

完成安装验收

先检查 Gateway:

openclaw gateway status

预期看到 Gateway 正在监听 18789 端口。随后打开控制界面:

openclaw dashboard

浏览器能够加载 Control UI 后,在聊天框发送一条普通测试消息。收到 AI 回复,表示 CLI、Gateway、模型认证、Dashboard 与基本对话链路均已连通。仅能打开页面但没有收到回复,不应视为完整验收通过。

Gateway 未运行时检查

如果状态检查未显示 Gateway 正常监听,先确认此前是否同意安装后台服务;未安装时重新执行 openclaw gateway install 和 openclaw gateway start。仍不能启动时运行:

openclaw triage

该命令执行只读健康检查,并生成已清理敏感信息的诊断提示;也可运行 openclaw doctor 自行查看配置问题。处理诊断结果后,再重复 Gateway 状态、Dashboard 加载和首条消息三项验收。

官方参考资料

继续阅读