AI / 自動化
2026年6月1日
一行 openclaw onboard：10 分鐘在 Windows（WSL2）配好 OpenClaw 助理
VpsGona 技術團隊
2026年6月1日
~12 分鐘
用 openclaw onboard 在 WSL2 約 10 分鐘 完成 OpenClaw 互動式設定。官方：Windows 文件。相關：OpenClaw 部署、OpenClaw + Ollama、首小時引導、無頭閘道。
披露：可選雲 Mac 由 VpsGona 提供。
為何用 onboard
WSL2 內 openclaw onboard --install-daemon 註冊 systemd 服務，關閉終端後仍運行。設定目錄 ~/.openclaw/。
WSL2 與原生對比
| 路徑 | 命令 | 背景 | 適合 |
|---|---|---|---|
| WSL2（推薦） | openclaw onboard --install-daemon | systemd | 完整精靈 |
| 原生 Windows | openclaw onboard | 排程工作 | 快速測試 |
| 跳過健康檢查 | --skip-health | gateway run | 攔截時 |
前置條件
- WSL2 + Ubuntu
- Node 22+
- API Key
8 步上手
wsl --install- 更新 Ubuntu 套件
- 安裝 Node 22+
curl -fsSL https://openclaw.ai/install.sh | bashopenclaw onboard --install-daemon- 完成精靈並複製 Dashboard URL
- Windows 瀏覽器開啟
openclaw gateway status
精靈內容
模型、閘道、可選渠道與 Skills。渠道可日後再設。
除錯
無法開啟 Dashboard
使用 netsh interface portproxy 轉發 PORT。
健康檢查失敗
--skip-health 後 openclaw gateway run。
下一步
常見問題
openclaw onboard 做什么？
交互式向导：写入 ~/.openclaw/、启动网关、输出 Dashboard 链接。
要不要加 --install-daemon？
WSL2 内建议加，注册 systemd 后台服务；原生 Windows 机制不同。
大概多久？
WSL 与 Node 就绪后约 10 分钟；首次 wsl --install 需重启。
向导里渠道能跳过吗？
可以，之后 openclaw configure 再配。
浏览器打不开 Dashboard？
用 netsh portproxy 把 WSL 端口转发到 Windows。