Pular para o conteúdo principal
Qianfan é a plataforma MaaS da Baidu, fornecendo uma API unificada que encaminha solicitações para muitos modelos por trás de um único endpoint e chave de API. Ela é compatível com OpenAI, então a maioria dos SDKs da OpenAI funciona ao trocar a URL base.
PropriedadeValor
Provedorqianfan
AutenticaçãoQIANFAN_API_KEY
APICompatível com OpenAI
URL basehttps://qianfan.baidubce.com/v2

​
Instalar Plugin

Instale o Plugin oficial e reinicie o Gateway: 
openclaw plugins install @openclaw/qianfan-provider
openclaw gateway restart

​
Primeiros passos

1

Crie uma conta Baidu Cloud

Cadastre-se ou entre no Console do Qianfan e garanta que você tenha o acesso à API do Qianfan habilitado.
2

Gere uma chave de API

Crie um novo aplicativo ou selecione um existente e gere uma chave de API. O formato da chave é bce-v3/ALTAK-....
3

Execute o onboarding

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

Verifique se o modelo está disponível

openclaw models list --provider qianfan

​
Catálogo integrado

Ref. do modeloEntradaContextoSaída máx.RaciocínioObservações
qianfan/deepseek-v3.2texto98,30432,768SimModelo padrão
qianfan/ernie-5.0-thinking-previewtexto, imagem119,00064,000SimMultimodal
A ref. de modelo padrão é qianfan/deepseek-v3.2. Você só precisa substituir models.providers.qianfan quando precisar de uma URL base personalizada ou de metadados de modelo.

​
Exemplo de configuração

{
  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,
          },
        ],
      },
    },
  },
}
O Qianfan é executado pelo caminho de transporte compatível com OpenAI, não pela formatação de solicitações nativa da OpenAI. Isso significa que recursos padrão dos SDKs da OpenAI funcionam, mas parâmetros específicos do provedor podem não ser encaminhados.
O catálogo estático atualmente inclui deepseek-v3.2 e ernie-5.0-thinking-preview. Adicione ou substitua models.providers.qianfan somente quando precisar de uma URL base personalizada ou de metadados de modelo.
As refs. de modelo usam o prefixo qianfan/ (por exemplo, qianfan/deepseek-v3.2).
  • Garanta que sua chave de API comece com bce-v3/ALTAK- e tenha o acesso à API do Qianfan habilitado no console do Baidu Cloud.
  • Se os modelos não forem listados, confirme que sua conta tem o serviço Qianfan ativado.
  • A URL base padrão é https://qianfan.baidubce.com/v2. Altere-a somente se você usar um endpoint personalizado ou proxy.

​
Relacionados

Seleção de modelos

Escolher provedores, refs. de modelo e comportamento de failover.

Referência de configuração

Referência completa de configuração do OpenClaw.

Configuração de agente

Configurar padrões de agente e atribuições de modelo.

Documentação da API do Qianfan

Documentação oficial da API do Qianfan.