openclaw windows安装

OpenClaw Windows 安装教程(含网关报错排查)

针对百度高频词“openclaw windows安装/部署”,提供可复现的完整安装路径和问题诊断步骤。

最后更新: 2026-03-11

  • Windows 场景优先用 WSL2(官方强烈建议)
  • 源码/NPM 路径需满足 Node >= 22
  • 安装后执行 openclaw onboard --install-daemon
openclaw windows安装openclaw windows部署openclaw 安装报错

1. 安装前检查

官方建议 Windows 用户通过 WSL2 运行,先把环境一次性配齐。

  • Windows 11 / Windows 10 + WSL2
  • 若走源码或 npm 方式:Node >= 22 与 Git 可用
  • 准备好网关 token 与模型 API Key(仅放环境变量)

2. 官方安装流程(Windows)

优先走官方安装脚本;脚本执行后再完成 onboarding。

  1. 在 PowerShell 运行官方 install.ps1
  2. 安装完成后运行 openclaw onboard --install-daemon
  3. 按向导完成网关、渠道、模型配置
  4. 通过 healthz 和最小任务确认可用

官方脚本 + onboarding(Windows)

# PowerShell\n& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1)))\n\n# 安装完成后\nopenclaw onboard --install-daemon

3. 网关启动失败处理

优先确认监听地址、token 与端口,再看网关日志。

  • 确认 `127.0.0.1:18789` 未被占用并可访问 `/healthz`
  • 检查 `OPENCLAW_GATEWAY_TOKEN` 和 API Key 是否生效
  • 使用 `docker compose logs --since=30m openclaw-gateway` 定位具体报错

常见问题

Windows 安装后页面打不开怎么办?

先确认服务进程是否正常,再检查端口、防火墙和本地代理设置。

必须用 Docker 吗?

不是必须。Windows 端官方更推荐 WSL2 路径;Docker 适合做可重复部署。

参考来源