Skip to main content

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 is Baidu’s MaaS platform, providing a unified API that routes requests to many models behind a single endpoint and API key. It is OpenAI-compatible, so most OpenAI SDKs work by switching the base URL.
PropertyValue
Providerqianfan
AuthQIANFAN_API_KEY
APIOpenAI-compatible
Base URLhttps://qianfan.baidubce.com/v2

​
Getting started

1

Create a Baidu Cloud account

Sign up or log in at the Qianfan Console and ensure you have Qianfan API access enabled.
2

Generate an API key

Create a new application or select an existing one, then generate an API key. The key format is bce-v3/ALTAK-....
3

Run onboarding

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

Verify the model is available

openclaw models list --provider qianfan

​
Built-in catalog

Model refInputContextMax outputReasoningNotes
qianfan/deepseek-v3.2text98,30432,768YesDefault model
qianfan/ernie-5.0-thinking-previewtext, image119,00064,000YesMultimodal
The default bundled model ref is qianfan/deepseek-v3.2. You only need to override models.providers.qianfan when you need a custom base URL or model metadata.

​
Config example

{
  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 runs through the OpenAI-compatible transport path, not native OpenAI request shaping. This means standard OpenAI SDK features work, but provider-specific parameters may not be forwarded.
The bundled catalog currently includes deepseek-v3.2 and ernie-5.0-thinking-preview. Add or override models.providers.qianfan only when you need a custom base URL or model metadata.
Model refs use the qianfan/ prefix (for example qianfan/deepseek-v3.2).
  • Ensure your API key starts with bce-v3/ALTAK- and has Qianfan API access enabled in the Baidu Cloud console.
  • If models are not listed, confirm your account has the Qianfan service activated.
  • The default base URL is https://qianfan.baidubce.com/v2. Only change it if you use a custom endpoint or proxy.

Model selection

Choosing providers, model refs, and failover behavior.

Configuration reference

Full OpenClaw configuration reference.

Agent setup

Configuring agent defaults and model assignments.

Qianfan API docs

Official Qianfan API documentation.