openclaw windows安装
OpenClaw Windows 安装教程(含网关报错排查)
针对百度高频词“openclaw windows安装/部署”,提供可复现的完整安装路径和问题诊断步骤。
1. 安装前检查
官方建议 Windows 用户通过 WSL2 运行,先把环境一次性配齐。
- Windows 11 / Windows 10 + WSL2
- 若走源码或 npm 方式:Node >= 22 与 Git 可用
- 准备好网关 token 与模型 API Key(仅放环境变量)
2. 官方安装流程(Windows)
优先走官方安装脚本;脚本执行后再完成 onboarding。
- 在 PowerShell 运行官方 install.ps1
- 安装完成后运行 openclaw onboard --install-daemon
- 按向导完成网关、渠道、模型配置
- 通过 healthz 和最小任务确认可用
官方脚本 + onboarding(Windows)
# PowerShell\n& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1)))\n\n# 安装完成后\nopenclaw onboard --install-daemon3. 网关启动失败处理
优先确认监听地址、token 与端口,再看网关日志。
- 确认 `127.0.0.1:18789` 未被占用并可访问 `/healthz`
- 检查 `OPENCLAW_GATEWAY_TOKEN` 和 API Key 是否生效
- 使用 `docker compose logs --since=30m openclaw-gateway` 定位具体报错
常见问题
Windows 安装后页面打不开怎么办?
先确认服务进程是否正常,再检查端口、防火墙和本地代理设置。
必须用 Docker 吗?
不是必须。Windows 端官方更推荐 WSL2 路径;Docker 适合做可重复部署。