一行 openclaw onboard：10 分钟在 Windows（WSL2）配好你的 OpenClaw 助理
OpenClaw 在 GitHub 上已有 24 万+ star 量级热度，但 Windows 小白常被 WSL、Node、守护进程安装卡住。官方解法就是交互式向导 openclaw onboard——像开盲盒一样按提示选模型、网关与渠道，配置写入 ~/.openclaw/，约 10 分钟 可在本机跑通。文档：OpenClaw Windows 平台说明。相关：Mac mini M4 OpenClaw 部署、OpenClaw + Ollama、首小时引导、无头网关手册。
披露说明：VpsGona 提供可选云 Mac。OpenClaw 为独立开源项目。
大陆用户建议：WSL 内配置 npm 镜像后再执行安装脚本；首次 wsl --install 需重启，整体仍比折腾多套 Python 虚拟环境省事。
为何用 openclaw onboard 最快
只装 CLI 不会自动帮你填 API Key、拉起网关后台。一行 openclaw onboard --install-daemon（在 WSL2 内）可走完整盲盒式向导，并注册 systemd 用户服务，关掉终端后 Agent 仍在。
可引用结论： 配置目录 ~/.openclaw/；WSL2 下务必加 --install-daemon，原生 Windows 机制不同，见官方说明。
WSL2 与原生 Windows 对比
| 路径 | 命令 | 后台 | 适合 |
|---|---|---|---|
| WSL2（推荐） | openclaw onboard --install-daemon | systemd 用户服务 | 完整向导 + Linux 工具 |
| 原生 Windows | openclaw onboard | 计划任务/启动项 | 快速体验 |
| 原生跳过健康检查 | openclaw onboard --non-interactive --skip-health | openclaw gateway run | 健康检查拦截时 |
建议： 除非公司禁用 Hyper-V，否则一律 WSL2 + Ubuntu。
前置条件
- Windows 10/11，管理员 PowerShell 执行
wsl --install - 默认发行版 Ubuntu 24.04（或同类）
- WSL 内 Node.js 22+
- OpenAI/Anthropic 等 API Key
- WSL 虚拟磁盘预留约 2GB
8 步上手（Windows → WSL2 → onboard）
- 管理员 PowerShell：
wsl --install，重启后wsl -l -v为 2。 - 打开 Ubuntu：
sudo apt update && sudo apt upgrade -y - 安装 Node 22+，
node -v验证。 - 安装 OpenClaw：
curl -fsSL https://openclaw.ai/install.sh | bash source ~/.bashrc openclaw --version - 核心命令：
openclaw onboard --install-daemon - 按向导选：模型与 Key → 网关 → 渠道（可先跳过）→ Skills → 启动网关，复制控制台里的 Dashboard 链接。
- 在 Windows 浏览器打开该链接（若打不开见下方排错）。
openclaw gateway status检查；关掉 WSL 窗口，确认服务仍在线。
向导会配置什么
所有配置在 WSL 的 ~/.openclaw/。Telegram 需 BotFather Token，第一天可跳过。无 GUI 自动化见 无头网关手册。
排错
Windows 浏览器打不开 Dashboard
多为 WSL2 网络隔离。管理员 PowerShell 端口转发（将 PORT 换成仪表盘端口，如 18789）：
$wslIp = (wsl hostname -I).Trim().Split()[0]
netsh interface portproxy add v4tov4 `
listenport=PORT listenaddress=0.0.0.0 `
connectport=PORT connectaddress=$wslIp原生 Windows 健康检查失败
openclaw onboard --non-interactive --skip-health
openclaw gateway run长期使用仍建议迁到 WSL2。
下一步
- 先玩通向导，再
openclaw configure加 Telegram/Slack。 - 本地模型：OpenClaw + Ollama（WSL 里装 Ollama 即可）。
- 没有 Windows 机器：可看 云 Mac 部署指南（可选租用）。
常见问题
openclaw onboard 做什么？
交互式向导：写入 ~/.openclaw/、启动网关、输出 Dashboard 链接。
要不要加 --install-daemon？
WSL2 内建议加，注册 systemd 后台服务；原生 Windows 机制不同。
大概多久？
WSL 与 Node 就绪后约 10 分钟；首次 wsl --install 需重启。
向导里渠道能跳过吗？
可以，之后 openclaw configure 再配。
浏览器打不开 Dashboard？
用 netsh portproxy 把 WSL 端口转发到 Windows。