Qianfan

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

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

安装插件¶

安装官方插件：

openclaw plugins install @openclaw/qianfan-provider

安装会自动应用到正在运行的 Gateway；否则将在下次启动时生效。请参阅应用更改并检查。

快速开始¶

1. 创建百度云账户

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

2. 生成 API 密钥

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

3. 运行启动引导

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

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

4. 验证模型可用

openclaw models list --provider qianfan

内置目录¶

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

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

设置会保存连接参数和别名，而不会将生成的目录行复制到你的配置中。显式使用 models.mode: "replace" 可保持目录预置启用；自定义模型行将保持不变。

Tip

仅当你需要自定义 base 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,
          },
        ],
      },
    },
  },
}

Note

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

传输与兼容性

Qianfan 通过兼容 OpenAI 的传输路径运行，而非原生 OpenAI 请求整形。标准 OpenAI SDK 功能可用，但 provider 特定的参数可能不会被转发。

故障排除

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

模型选择

选择 provider、模型引用和故障转移行为。

配置参考

完整的 OpenClaw 配置参考。

Agent 设置

配置 agent 默认设置和模型分配。

Qianfan API 文档

Qianfan API 官方文档。

本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 cl/openclaw