Qianfan

Qianfan 是百度的 MaaS 平台：一个统一的、兼容 OpenAI 的 API，通过单一端点和 API 密钥将请求路由到许多模型。OpenClaw 将其作为官方外部插件 @openclaw/qianfan-provider 提供。

属性	值
服务商	`qianfan`
认证	`QIANFAN_API_KEY`
API	兼容 OpenAI（`openai-completions`）
基础 URL	`https://qianfan.baidubce.com/v2`
默认模型	`qianfan/deepseek-v4-pro`

安装插件

安装官方插件，然后重启 Gateway：

openclaw plugins install @openclaw/qianfan-provider
openclaw gateway restart

快速开始

创建百度云账号

在 Qianfan 控制台注册或登录，并确保你已启用 Qianfan API 访问权限。

生成 API 密钥

创建一个新应用或选择一个已有应用，然后生成一个 API 密钥。百度云密钥使用 bce-v3/ALTAK-... 格式。

运行引导

openclaw onboard --auth-choice qianfan-api-key

非交互式运行会从 --qianfan-api-key <key> 或 QIANFAN_API_KEY 读取密钥。引导流程会写入提供商配置，为默认模型添加 QIANFAN 别名，并在未配置默认模型时将 qianfan/deepseek-v4-pro 设置为默认模型。

验证模型是否可用

openclaw models list --provider qianfan

内置目录

模型引用	输入	上下文	最大输出	推理	备注
`qianfan/deepseek-v4-pro`	文本	1,000,000	393,216	是	当前 DeepSeek 旗舰模型
`qianfan/ernie-5.1`	文本	128,000	65,536	否	最新 ERNIE 文本旗舰模型
`qianfan/ernie-5.0`	文本、图像	128,000	65,536	是	当前多模态和思考模型
`qianfan/deepseek-v3.2`	文本	128,000	32,768	否	已弃用的接入兼容性默认模型；由 `deepseek-v4-pro` 替代
`qianfan/ernie-5.0-thinking-preview`	文本、图像	128,000	65,536	是	已弃用的别名；由 `ernie-5.0` 替代

目录是静态的；没有实时模型发现。

只有在需要自定义基础 URL 或模型元数据时，才需要覆盖 models.providers.qianfan。

配置示例

此示例明确选择当前的 DeepSeek 旗舰模型，而不是引导流程中的兼容性默认模型。

{
  env: { vars: { QIANFAN_API_KEY: "bce-v3/ALTAK-..." } },
  agents: {
    defaults: {
      model: { primary: "qianfan/deepseek-v4-pro" },
      models: {
        "qianfan/deepseek-v4-pro": { alias: "QIANFAN" },
      },
    },
  },
  models: {
    providers: {
      qianfan: {
        baseUrl: "https://qianfan.baidubce.com/v2",
        api: "openai-completions",
        models: [
          {
            id: "deepseek-v4-pro",
            name: "DeepSeek V4 Pro",
            reasoning: true,
            input: ["text"],
            cost: {
              input: 1.771957,
              output: 3.543915,
              cacheRead: 0.147663,
              cacheWrite: 0,
            },
            contextWindow: 1000000,
            maxTokens: 393216,
          },
        ],
      },
    },
  },
}

模型引用使用 qianfan/ 前缀（例如 qianfan/deepseek-v4-pro）。

传输和兼容性

Qianfan 通过与 OpenAI 兼容的传输路径运行，而不是原生的 OpenAI 请求格式。标准 OpenAI SDK 功能可以正常工作，但特定于提供商的参数可能不会被传递。

故障排查

确保你的 API 密钥以 bce-v3/ALTAK- 开头，并且已在百度智能云控制台中启用 Qianfan API 访问权限。
如果未列出模型，请确认你的账户已激活 Qianfan 服务。
只有在使用自定义端点或代理时才更改基础 URL。

模型选择

选择提供方、模型引用和故障切换行为。

配置参考

完整的 OpenClaw 配置参考。

Agent 设置

配置 Agent 默认值和模型分配。

Qianfan API 文档

官方 Qianfan API 文档。

概览

概念与配置

提供商

安装插件

快速开始

内置目录

配置示例

相关

模型选择

配置参考

Agent 设置

Qianfan API 文档

​安装插件

​快速开始

​内置目录

​配置示例

​相关

模型选择

配置参考

Agent 设置

Qianfan API 文档

安装插件

快速开始

内置目录

配置示例

相关