百度千帆

百度千帆（Qianfan）是百度智能云推出的大模型开发平台，提供文心一言（ERNIE）系列模型及丰富的 AI 开发工具。

获取 API Key

1. 前往 百度智能云控制台 注册并登录
2. 开通千帆大模型服务
3. 在「应用接入」中创建应用
4. 获取 API Key 和 Secret Key

配置 OpenClaw

openclaw models auth login --provider qianfan
# 按提示输入 API Key 和 Secret Key

或手动编辑配置文件：

// ~/.openclaw/config.json
{
  "models": {
    "providers": {
      "qianfan": {
        "apiKey": "xxxxxxxxxxxxxxxxxxxxxxxx",
        "secretKey": "xxxxxxxxxxxxxxxxxxxxxxxx",
        "baseUrl": "https://aip.baidubce.com"
      }
    }
  }
}

支持的模型（ERNIE 系列）

模型 ID	说明	上下文窗口
ernie-4.0-8k	ERNIE 4.0 旗舰版	8K
ernie-4.0-turbo-8k	ERNIE 4.0 Turbo 快速版	8K
ernie-3.5-8k	ERNIE 3.5 标准版	8K
ernie-3.5-128k	ERNIE 3.5 长文本版	128K
ernie-speed-8k	轻量快速版，免费使用	8K
ernie-speed-128k	轻量长文本版，免费使用	128K
ernie-lite-8k	超轻量版，免费使用	8K

使用示例：

# 设置为默认模型
openclaw models default set qianfan/ernie-4.0-8k

# 使用免费模型
openclaw chat --model qianfan/ernie-speed-128k "请帮我分析这段文本"

特色功能

免费模型

ERNIE Speed 和 ERNIE Lite 系列免费使用，适合体验和开发测试。

知识增强

ERNIE 模型基于百度的知识图谱（Knowledge Graph）进行增强训练，在中文问答和知识推理方面表现突出。

插件调用

千帆平台支持模型调用外部插件，如百度搜索、天气查询等。

环境变量

export QIANFAN_API_KEY="xxxxxxxxxxxxxxxxxxxxxxxx"
export QIANFAN_SECRET_KEY="xxxxxxxxxxxxxxxxxxxxxxxx"

故障排查

认证失败

• 确认 API Key 和 Secret Key 均已正确填写
• 检查应用是否已开通对应模型的权限

模型调用失败

• 部分模型需要在控制台中手动开通
• 确认账户余额充足（免费模型除外）

响应格式问题

• 千帆平台的 API 格式与 OpenAI 略有不同
• OpenClaw 已做适配，如遇问题请升级到最新版本

🇨🇳 中国用户须知

• 无需代理：百度智能云是国内服务，可直接访问
• 免费额度：ERNIE Speed / Lite 系列免费使用，无需充值即可体验
• 实名要求：需要完成百度智能云的实名认证
• 企业支持：百度千帆提供完善的企业级支持和 SLA 保障
• 付费方式：支持支付宝、微信支付、银行转账