本文将带你在 Windows 上运行 OpenClaw,并通过 XAI Router(xairouter) 使用 gpt-5.4。
可按以下两种方式进行:
- Windows 非 Docker(推荐:WSL2 + Ubuntu):CLI + Gateway 跑在 WSL2 的 Linux 环境内
- Windows 使用 Docker(Docker Desktop + Docker Compose):Gateway 跑在容器里
- 模板仓库:https://github.com/xaixagent/openclaw
- 推荐上游协议:OpenAI Responses()
- 默认上游模型:
- 你只需要:
- 一个可用的 OpenClaw Gateway(默认端口 )
- 一个 OpenResponses 兼容入口:
- 默认上游模型:
- Windows 10⁄11
- 一个 XAI Router API Key(形如 )
二选一:
- 方式一(推荐):WSL2 + Ubuntu
- 方式二:Docker Desktop + Docker Compose
OpenClaw 在 Windows 上官方推荐使用 WSL2(Ubuntu 推荐),这样 Node/Bun/pnpm 以及很多工具链兼容性更好。
这一方式的核心思路是:把 OpenClaw 当作 Linux 应用跑在 WSL2 里。
打开 PowerShell(建议管理员权限)执行:
如系统提示重启,请按提示重启。
在 WSL2 终端里执行:
然后回到 PowerShell 执行:
重新打开 Ubuntu,再验证:
推荐使用官方安装脚本(会处理 Node 检测/安装):
验证安装:
- 设置环境变量:
- 写入 OpenClaw 配置文件 :
说明:这套配置会让 OpenClaw 以上游 方式连接 XAI Router;不需要额外添加 , 会优先走 HTTP 。如果你偏好 WebSocket-first,可改成 。
在 WSL2 里运行:
你会收到一个 OpenResponses 风格 的 JSON 响应。
这一方式的核心思路是:Gateway 跑在容器里,你只需要填 就能启动。
在 PowerShell 中执行:
这个目录里最关键的文件:
- :定义 与
- :环境变量模板
- :放你自己的 OpenClaw 配置
编辑 ,至少需要三项:
- :你的 XAI Router Key
- :Gateway 的访问令牌(用于 HTTP )
- :设为
生成一个随机的 (推荐 32 字节 / 64 个十六进制字符):
一个最小可用的 示例:
查看运行状态:
查看启动日志(第一次启动建议看一下):
如果你的环境只有 ,请把上面的 替换为 。
在同一台机器执行(PowerShell 中 可能是别名,建议使用 ):
这不是上游模型名,而是 OpenClaw Gateway 的“统一模型名”。
- 你的应用侧:始终写
- 真正的上游模型:由配置决定(本教程默认为 )
只要把 OpenAI SDK 的:
- 指向你的 Gateway:
- 填
即可像调用 OpenAI Responses 一样调用 OpenClaw。
Node.js( SDK)示例:
如果你希望局域网内其它机器访问 Gateway,可能需要放行 Windows 防火墙(管理员 PowerShell,示例端口 ):
停止并删除容器(保留数据目录 ):
升级镜像并重启:
如果你需要“彻底重置”(会清掉会话/状态数据),可以:
想了解 OpenClaw 通过 XAI Router 接入更多模型/协议,可参考:/blog/openclaw/
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/212865.html