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

Qianfan

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.

Property	Value
Provider	text `qianfan`
Auth	text `QIANFAN_API_KEY`
API	OpenAI-compatible
Base URL	text `https://qianfan.baidubce.com/v2`

Getting started

Create a Baidu Cloud account

Sign up or log in at the [Qianfan Console](https://console.bce.baidu.com/qianfan/ais/console/apiKey) and ensure you have Qianfan API access enabled.

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-...`.

Run onboarding

```bash} openclaw onboard --auth-choice qianfan-api-key ```

Verify the model is available

```bash} openclaw models list --provider qianfan ```

Built-in catalog

Model ref	Input	Context	Max output	Reasoning	Notes
text `qianfan/deepseek-v3.2`	text	98,304	32,768	Yes	Default model
text `qianfan/ernie-5.0-thinking-preview`	text, image	119,000	64,000	Yes	Multimodal

tip

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


json5
{
  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,
          },
        ],
      },
    },
  },
}

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.

OpenClaw Docs