Skip to main content
Qianfan 是百度的 MaaS 平台:提供统一且兼容 OpenAI 的 API,通过单一端点和 API key 将请求路由到多个模型。OpenClaw 将其作为官方外部插件 @openclaw/qianfan-provider 提供。

安装插件

安装官方插件,然后重启 Gateway 网关:

入门指南

1

创建百度智能云账号

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

生成 API key

创建新应用或选择现有应用,然后生成 API key。百度智能云密钥采用 bce-v3/ALTAK-... 格式。
3

运行新手引导

非交互式运行会从 --qianfan-api-key <key>QIANFAN_API_KEY 读取密钥。新手引导会写入提供商配置,为默认模型添加 QIANFAN 别名,并在尚未配置默认模型时将 qianfan/deepseek-v3.2 设置为默认模型。
4

验证模型是否可用

内置目录

目录是静态的;不支持实时模型发现。
仅当需要自定义基础 URL 或模型元数据时,才需要覆盖 models.providers.qianfan

配置示例

模型引用使用 qianfan/ 前缀(例如 qianfan/deepseek-v3.2)。
Qianfan 使用兼容 OpenAI 的传输路径,而非原生 OpenAI 请求格式。标准 OpenAI SDK 功能可以正常工作,但提供商特有的参数可能不会被转发。
  • 确保 API key 以 bce-v3/ALTAK- 开头,并已在百度智能云控制台中启用 Qianfan API 访问权限。
  • 如果未列出模型,请确认账号已开通 Qianfan 服务。
  • 仅在使用自定义端点或代理时更改基础 URL。

相关内容

模型选择

选择提供商、模型引用和故障转移行为。

配置参考

完整的 OpenClaw 配置参考。

智能体设置

配置智能体默认值和模型分配。

Qianfan API 文档

Qianfan API 官方文档。