使用白B.AI 集成 OpenClaw

15 分钟从零开始部署你的私人 AI Agent：通过白B.AI 部署 OpenClaw

OpenClaw（原名 ClawdBot 或 Moltbot）是一款开源的个人 AI 助手。与基于云端的 SaaS 工具不同，OpenClaw 运行在你自己的本地设备上，让你能够完全掌控自己的数据、工作流和运行环境。

你可以通过 Telegram、WhatsApp、Lark、钉钉等熟悉的消息平台与 OpenClaw 交互，用它处理邮件管理、日历整理、代码编写以及日常工作流自动化等任务。

OpenClaw 不只是一个聊天机器人，它是一个能够真正执行任务的 AI Agent。它支持持久化记忆、访问你的本地文件系统和互联网，并且可以通过可安装的 skills 进行扩展。

由于 OpenClaw 是开源且可自托管的，它已经吸引了大量开发者和技术爱好者。用户已经基于它构建了从商业自动化到个人效率提升等各种创新用例，展示了真正属于个人的 AI 助手所具备的潜力。

本指南将带你完成完整的配置流程，包括安装、初始化，以及将 OpenClaw 连接到白B.AI API。完成后，你将拥有一个在本地运行的私人 AI Agent。

第 1 步：获取你的白B.AI API Key

在配置 OpenClaw 之前，你需要先获取一个白B.AI API Key。

登录白B.AI Chat
进入 API Key 管理页面
创建或复制你的 api_key

请妥善保管这个 Key。你将在下面的配置步骤中使用它。

第 2 步：准备系统环境

在安装之前，请确保你的系统满足以下要求。

要求	说明
Node.js	推荐使用 Node.js 24。也支持 Node.js 22.14+。
操作系统	macOS、Linux 或 Windows。支持原生 Windows 和 WSL2，但推荐使用 WSL2 以获得更好的兼容性。
包管理器	标准安装支持 npm；从源码构建时通常使用 pnpm。

要检查你的 Node.js 版本，请打开终端并运行：

node --version

如果尚未安装 Node.js，或者版本过低，请前往官网安装或升级：

https://nodejs.org/

第 3 步：安装 OpenClaw

OpenClaw 支持多种安装方式。对于大多数用户来说，最简单的方法是全局安装最新版本的 CLI。

方式 1：使用 npm 安装

npm install -g openclaw@latest

方式 2：使用官方安装脚本

macOS / Linux

curl -fsSL https://openclaw.ai/install.sh | bash

Windows PowerShell

iwr -useb https://openclaw.ai/install.ps1 | iex

以上两种方式任选其一。安装完成后，继续执行初始化步骤。

第 4 步：完成初始化向导

安装完成后，运行以下初始化命令：

openclaw onboard --install-daemon

该命令会启动初始化向导，并安装本地 Gateway 服务。

在初始化过程中，OpenClaw 会引导你完成多个配置部分，例如：

AI 模型提供商设置
通信渠道配置
Skills 和可选功能
本地后台服务

如果你打算手动配置白B.AI，可以在初始化过程中跳过默认模型提供商的设置，然后继续进行下面的手动配置步骤。

初始化完成后，OpenClaw 就可以进行自定义模型配置了。

第 5 步：配置白B.AI 模型

完成初始化后，你需要手动将白B.AI 模型提供商添加到 OpenClaw 配置文件中，并将其设置为默认模型。

有两种配置方式：

一键脚本： 如果官方提供了一键脚本教程，可以直接按照教程操作
手动配置： 按照下面的步骤进行设置

配置说明： 下面的手动配置使用当前的 b.ai provider 命名空间和 api.b.ai 域名，与最新的白B.AI 品牌和 API 地址保持一致。

5.1 打开配置文件

打开配置文件：

vim ~/.openclaw/openclaw.json

OpenClaw 会在启动时读取该文件，以加载模型提供商和 Agent 设置。

5.2 添加白B.AI 提供商配置

找到 "models" 部分，并合并以下配置内容。

请将 {B.AI_API_KEY} 替换为你自己的白B.AI API Key。

{
  "models": {
    "mode": "merge",
    "providers": {
      "b.ai": {
        "baseUrl": "https://api.b.ai/v1/",
        "apiKey": "{B.AI_API_KEY}",
        "api": "openai-completions",
        "models": [
          {
            "id": "gpt-5.2",
            "name": "gpt-5.2"
          },
          {
            "id": "gpt-5-mini",
            "name": "gpt-5-mini"
          },
          {
            "id": "gpt-5-nano",
            "name": "gpt-5-nano"
          },
          {
            "id": "claude-opus-4.6",
            "name": "claude-opus-4.6"
          },
          {
            "id": "claude-sonnet-4.6",
            "name": "claude-sonnet-4.6"
          },
          {
            "id": "claude-haiku-4.5",
            "name": "claude-haiku-4.5"
          }
        ]
      }
    }
  }
}

5.3 设置默认模型

在同一个 openclaw.json 文件中，按当前 OpenClaw 实际识别的结构设置默认模型：

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "b.ai/gpt-5-nano"
      },
      "models": {
        "b.ai/gpt-5-nano": {
          "alias": "gpt-5-nano"
        }
      }
    }
  }
}

这一步会告诉 OpenClaw 默认使用当前官方推荐的 b.ai provider 命名空间。如果你还暴露了多个白B.AI模型，建议一并把它们加到 agents.defaults.models 里，方便 openclaw models status 和 openclaw models set ... 正确识别。

5.4 重启 Gateway

保存配置文件后，重启 Gateway，使配置生效：

openclaw gateway restart

如果 CLI 提示 Gateway 服务尚未安装，请先执行：

openclaw gateway install
openclaw gateway restart

然后再用下面的命令确认状态：

openclaw gateway status

5.5 测试连接

在终端中发送一条简单的测试消息：

openclaw agent --agent main --message "How are you doing today?"

如果 OpenClaw 返回了有效响应，说明与白B.AI 的连接已经正常工作。如果你看到的是余额不足或 billing 相关报错，通常说明 provider 已经接通，但当前 API Key 的余额还不足以完成这次请求。

第 6 步：了解 Gateway 和诊断命令

如果在配置过程中遇到问题，了解 Gateway 以及内置的诊断命令会很有帮助。

什么是 Gateway？

Gateway 是驱动 OpenClaw 运行时功能的本地服务层。它负责管理模型访问、本地服务和后台进程。

常用的 Gateway 命令如下：

操作	命令
安装 Gateway	`openclaw gateway install`
启动 Gateway	`openclaw gateway start`
停止 Gateway	`openclaw gateway stop`
重启 Gateway	`openclaw gateway restart`
卸载 Gateway	`openclaw gateway uninstall`
查看 Gateway 状态	`openclaw gateway status`

诊断命令

在完成初始化和配置后，可以运行以下命令检查当前环境：

openclaw doctor

你也可以直接检查 Gateway 状态：

openclaw gateway status

如果一切正常，Gateway 应显示 healthy 或 running 状态。

第 7 步：启动 OpenClaw

配置完成后，你可以通过 Web Dashboard 或终端界面与自己的 AI Agent 交互。

方式 1：Web Dashboard

启动 Dashboard：

openclaw dashboard

然后在浏览器中打开以下地址：

http://127.0.0.1:18789

在 Dashboard 中，你可以：

与 AI 对话
查看历史会话
配置模型
监控系统状态

方式 2：Terminal UI（TUI）

启动终端界面：

openclaw tui

常用 TUI 命令：

命令	说明
`/status`	查看当前系统状态
`/session <key>`	切换到指定聊天会话
`/model <name>`	切换当前使用的 LLM
`/help`	查看可用命令

第 8 步：了解常用命令

1. 检查模型状态

openclaw models status

2. 管理 Channels

openclaw channels list

3. 搜索记忆

openclaw memory search "keyword"

4. 查看文档

openclaw docs

完成

现在，你已经拥有了一个由 OpenClaw + 白B.AI 驱动的可用私人 AI Agent。

现在你可以：

构建自动化工作流
连接 Telegram 机器人
通过 skills 扩展能力
打造你自己的 AI Agent 产品

欢迎使用由白B.AI 提供支持的个人 AI 基础设施。

使用 白B.AI 集成 OpenClaw

15 分钟从零开始部署你的私人 AI Agent：通过 白B.AI 部署 OpenClaw​

第 1 步：获取你的 白B.AI API Key​

第 2 步：准备系统环境​

第 3 步：安装 OpenClaw​

方式 1：使用 npm 安装​

方式 2：使用官方安装脚本​

macOS / Linux​

Windows PowerShell​

第 4 步：完成初始化向导​

第 5 步：配置 白B.AI 模型​

5.1 打开配置文件​

5.2 添加 白B.AI 提供商配置​

5.3 设置默认模型​

5.4 重启 Gateway​

5.5 测试连接​

第 6 步：了解 Gateway 和诊断命令​

什么是 Gateway？​

诊断命令​

第 7 步：启动 OpenClaw​

方式 1：Web Dashboard​

方式 2：Terminal UI（TUI）​

第 8 步：了解常用命令​

1. 检查模型状态​

2. 管理 Channels​

3. 搜索记忆​

4. 查看文档​

完成​