跳轉到主要內容

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Qianfan 是 Baidu 的 MaaS 平台，提供統一 API，可透過單一端點和 API 金鑰將請求路由至許多模型。它與 OpenAI 相容，因此大多數 OpenAI SDK 只要切換基礎 URL 即可使用。
屬性值
提供者qianfan
驗證QIANFAN_API_KEY
API與 OpenAI 相容
基礎 URLhttps://qianfan.baidubce.com/v2

​
開始使用

1

建立 Baidu Cloud 帳戶

在 Qianfan Console 註冊或登入，並確認你已啟用 Qianfan API 存取權限。
2

產生 API 金鑰

建立新的應用程式或選取現有應用程式，然後產生 API 金鑰。金鑰格式為 bce-v3/ALTAK-...。
3

執行入門設定

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

確認模型可用

openclaw models list --provider qianfan

​
內建型錄

模型參照輸入上下文最大輸出推理備註
qianfan/deepseek-v3.2文字98,30432,768是預設模型
qianfan/ernie-5.0-thinking-preview文字、圖片119,00064,000是多模態
預設的隨附模型參照為 qianfan/deepseek-v3.2。只有在需要自訂基礎 URL 或模型中繼資料時，才需要覆寫 models.providers.qianfan。

​
設定範例

{
  env: { QIANFAN_API_KEY: "bce-v3/ALTAK-..." },
  agents: {
    defaults: {
      model: { primary: "qianfan/deepseek-v3.2" },
      models: {
        "qianfan/deepseek-v3.2": { alias: "QIANFAN" },
      },
    },
  },
  models: {
    providers: {
      qianfan: {
        baseUrl: "https://qianfan.baidubce.com/v2",
        api: "openai-completions",
        models: [
          {
            id: "deepseek-v3.2",
            name: "DEEPSEEK V3.2",
            reasoning: true,
            input: ["text"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 98304,
            maxTokens: 32768,
          },
          {
            id: "ernie-5.0-thinking-preview",
            name: "ERNIE-5.0-Thinking-Preview",
            reasoning: true,
            input: ["text", "image"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 119000,
            maxTokens: 64000,
          },
        ],
      },
    },
  },
}
Qianfan 會透過與 OpenAI 相容的傳輸路徑執行，而不是使用原生 OpenAI 請求塑形。這表示標準 OpenAI SDK 功能可以使用，但提供者特定參數可能不會被轉送。
隨附型錄目前包含 deepseek-v3.2 和 ernie-5.0-thinking-preview。只有在需要自訂基礎 URL 或模型中繼資料時，才新增或覆寫 models.providers.qianfan。
模型參照使用 qianfan/ 前綴（例如 qianfan/deepseek-v3.2）。
  • 確認你的 API 金鑰以 bce-v3/ALTAK- 開頭，且已在 Baidu Cloud 主控台啟用 Qianfan API 存取權限。
  • 如果沒有列出模型，請確認你的帳戶已啟用 Qianfan 服務。
  • 預設基礎 URL 是 https://qianfan.baidubce.com/v2。只有在使用自訂端點或 Proxy 時才變更它。

​
相關

模型選擇

選擇提供者、模型參照和容錯移轉行為。

設定參考

完整的 OpenClaw 設定參考。

Agent 設定

設定 Agent 預設值和模型指派。

Qianfan API 文件

官方 Qianfan API 文件。