OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

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:

bash
openclaw plugins install @openclaw/qianfan-provideropenclaw 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

    bash
    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

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

    Exemplo de configuração

    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,          },        ],      },    },  },}
    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.
    Was this useful?
    On this page

    On this page