Qianfan

Qianfan é a plataforma MaaS da Baidu: uma API unificada e compatível com a OpenAI que encaminha solicitações para diversos modelos por meio de um único endpoint e uma única chave de API. O OpenClaw a disponibiliza como o Plugin externo oficial @openclaw/qianfan-provider.

Propriedade	Valor
Provedor	`qianfan`
Autenticação	`QIANFAN_API_KEY`
API	Compatível com a OpenAI (`openai-completions`)
URL base	`https://qianfan.baidubce.com/v2`
Modelo padrão	`qianfan/deepseek-v3.2`

Instalar o Plugin

Instale o Plugin oficial e reinicie o Gateway:

openclaw plugins install @openclaw/qianfan-provider
openclaw gateway restart

Primeiros passos

Criar uma conta no Baidu Cloud

Cadastre-se ou faça login no console do Qianfan e verifique se o acesso à API do Qianfan está habilitado.

Gerar uma chave de API

Crie um novo aplicativo ou selecione um existente e gere uma chave de API. As chaves do Baidu Cloud usam o formato bce-v3/ALTAK-....

Executar a configuração inicial

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

As execuções não interativas leem a chave de --qianfan-api-key <key> ou QIANFAN_API_KEY. A configuração inicial grava a configuração do provedor, adiciona o alias QIANFAN ao modelo padrão e define qianfan/deepseek-v3.2 como modelo padrão quando nenhum estiver configurado.

Verificar se o modelo está disponível

openclaw models list --provider qianfan

Catálogo integrado

Referência do modelo	Entrada	Contexto	Saída máxima	Raciocínio	Observações
`qianfan/deepseek-v3.2`	texto	98,304	32,768	Sim	Modelo padrão
`qianfan/ernie-5.0-thinking-preview`	texto, imagem	119,000	64,000	Sim	Multimodal

O catálogo é estático; não há descoberta de modelos em tempo real.

Você só precisa substituir models.providers.qianfan quando precisar de uma URL base personalizada ou de metadados de modelo personalizados.

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

As referências de modelo usam o prefixo qianfan/ (por exemplo, qianfan/deepseek-v3.2).

Transporte e compatibilidade

O Qianfan usa o caminho de transporte compatível com a OpenAI, e não a formatação nativa de solicitações da OpenAI. Os recursos padrão do SDK da OpenAI funcionam, mas parâmetros específicos do provedor podem não ser encaminhados.

Solução de problemas

Verifique se sua chave de API começa com bce-v3/ALTAK- e se o acesso à API do Qianfan está habilitado no console do Baidu Cloud.
Se os modelos não forem listados, confirme se o serviço Qianfan está ativado em sua conta.
Altere a URL base somente se usar um endpoint personalizado ou um proxy.

Relacionados

Seleção de modelos

Escolha de provedores, referências de modelo e comportamento de failover.

Referência de configuração

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

Configuração do agente

Configuração dos padrões do agente e das atribuições de modelos.

Documentação da API do Qianfan

Documentação oficial da API do Qianfan.

Overview

Concepts and configuration

Providers

Instalar o Plugin

Primeiros passos

Catálogo integrado

Exemplo de configuração

Relacionados

Seleção de modelos

Referência de configuração

Configuração do agente

Documentação da API do Qianfan

​Instalar o Plugin

​Primeiros passos

​Catálogo integrado

​Exemplo de configuração

​Relacionados

Seleção de modelos

Referência de configuração

Configuração do agente

Documentação da API do Qianfan

Instalar o Plugin

Primeiros passos

Catálogo integrado

Exemplo de configuração

Relacionados