千帆是百度的 MaaS 平台，通过统一 API 路由到多个模型，OpenAI 兼容接口。
基本信息
| 属性 | 值 |
|---|
| Provider ID | qianfan |
| 认证 | QIANFAN_API_KEY（格式：bce-v3/ALTAK-...） |
| API 类型 | OpenAI 兼容 |
| Base URL | https://qianfan.baidubce.com/v2 |
内置模型
| 模型 ref | 输入 | Context | Max Output | 推理 | 说明 |
|---|
qianfan/deepseek-v3.2 | text | 98,304 | 32,768 | 是 | 默认模型 |
qianfan/ernie-5.0-thinking-preview | text, image | 119,000 | 64,000 | 是 | 多模态 |
快速配置
openclaw onboard --auth-choice qianfan-api-key
{
env: { QIANFAN_API_KEY: "bce-v3/ALTAK-..." },
agents: {
defaults: {
model: { primary: "qianfan/deepseek-v3.2" },
},
},
}
注意事项
- API key 格式固定为
bce-v3/ALTAK-...，需在百度云控制台开通千帆服务后生成
- 走 OpenAI 兼容传输路径，provider 特有参数可能不被转发
- 默认 base URL 为
https://qianfan.baidubce.com/v2，自定义端点时才需覆盖
相关链接
- model-providers — provider 规则与 model ref 格式
- docs/gateway/configuration-reference — 完整配置参考