一键脚本教程
快速开始
在运行此脚本之前，请确保：
- 推荐使用 Node.js 24，同时也支持 Node.js 22.14+
- OpenClaw 已安装并完成初始化
- 建议先运行
openclaw onboard --install-daemon - 你的网络连接正常，并且可以访问 白B.AI API
脚本命令
Linux 与 macOS：
Mac 用户：打开“应用程序”中的 Terminal（终端），然后运行以下命令：
curl -LsSf https://chat.b.ai/scripts/openclaw-install-bai-provider.sh | bash
Windows PowerShell：
Windows 用户：从开始菜单打开 PowerShell，然后运行以下命令（不支持 CMD）：
iwr -useb https://chat.b.ai/scripts/openclaw-install-bai-provider.ps1 | iex
说明： 当前官方一键脚本通过 白B.AI Chat 发布。
详细步骤
1. 创建 API Key
- 登录 白B.AI 平台
- 进入 API Key 管理页面
- 创建一个新的 API Key
2. 运行安装脚本
根据你的操作系统，运行上方对应的命令。
脚本会自动执行以下操作：
- 检查你的环境，包括 Node.js 和 OpenClaw
- 提示你输入 白B.AI API Key
- 将
baiprovider 配置写入 OpenClaw 配置文件 - 设置默认模型
- 如果本地 Gateway 已安装，则尝试重启相关服务
3. 选择默认模型
在校验 API Key 之后，脚本会拉取可用模型列表，并提示你选择一个默认模型。
说明： 某些 Gemini 系列模型在 OpenClaw 中可能无法稳定工作，因为部分 function calling 场景对客户端指纹校验更严格。请选择时务必留意。
4. 完成配置
完成模型选择后，脚本会自动执行以下操作：
- 备份你原有的配置文件
- 更新 OpenClaw 配置
- 尝试重启相关本地服务
重要说明： 脚本成功执行，并不一定代表 Gateway 服务已经安装并处于运行状态。脚本结束后，请务必再手动确认一次：
openclaw gateway status如果 CLI 提示服务尚未安装，请继续执行：
openclaw gateway install
openclaw gateway restart
5. 切换模型
你可以通过以下两种方式切换所使用的模型：
方式 1：命令行
openclaw models set bai/<model_name>
你也可以手动编辑 ~/.openclaw/openclaw.json 配置文件。
方式 2：Web UI - Dashboard
在浏览器中打开以下地址：
这是 OpenClaw 默认的 Dashboard 地址。
然后按以下步骤操作：
- 点击左侧导航菜单中的 Agent
- 找到 Primary model 下拉框
- 选择你想使用的模型
说明： 在 Dashboard 中修改模型后，命令行切换模型可能无法再按预期工作，因为 Dashboard 可能会自动在配置文件中添加一个
list字段。
兼容性测试
| 操作系统 | 状态 |
|---|---|
| Ubuntu 24.04 | ✅ 通过 |
| Windows 11 | ✅ 通过 |
| macOS | ✅ 通过 |
常见问题
Q：如果脚本运行失败，我该怎么办？
A：请确认以下几点：
- 已安装 Node.js 22.14+
- 已安装 OpenClaw
- 已完成初始化，最好运行过
openclaw onboard --install-daemon - 网络连接正常
- 可以访问 白B.AI API endpoint
- 你使用的是当前官方发布的 白B.AI Chat 脚本地址
- 脚本结束后，你已经用
openclaw gateway status确认过 Gateway 状态
Q：我该如何切换模型？
A：请查看上文 第 5 步：切换模型。
Q：如果我还没有安装 OpenClaw 怎么办？
A：请先安装 OpenClaw，然后运行：
openclaw onboard --install-daemon
完成 onboarding 后，再回来运行 白B.AI provider 安装脚本。
Q：我在哪里可以找到 OpenClaw Dashboard？
A：默认情况下，Dashboard 地址是：
Q：我可以不使用脚本，直接手动编辑配置吗？
A：可以。你可以手动编辑：
~/.openclaw/openclaw.json
并自行添加 bai provider 配置。