Providers
Qianfan
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.
| Propriedade | Valor |
|---|---|
| Provedor | qianfan |
| Autenticação | QIANFAN_API_KEY |
| API | Compatível com OpenAI |
| URL base | https://qianfan.baidubce.com/v2 |
Instalar Plugin
Instale o Plugin oficial e reinicie o Gateway:
openclaw plugins install @openclaw/qianfan-provideropenclaw gateway restartPrimeiros passos
Crie uma conta Baidu Cloud
Cadastre-se ou entre no Console do Qianfan e garanta que você tenha o acesso à API do Qianfan habilitado.
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-....
Execute o onboarding
openclaw onboard --auth-choice qianfan-api-keyVerifique se o modelo está disponível
openclaw models list --provider qianfanCatálogo integrado
| Ref. do modelo | Entrada | Contexto | Saída máx. | 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 |
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, }, ], }, }, },}Transporte e compatibilidade
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.
Catálogo e substituições
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.
Solução de problemas
- 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
Escolher provedores, refs. de modelo e comportamento de failover.
Referência completa de configuração do OpenClaw.
Configurar padrões de agente e atribuições de modelo.
Documentação oficial da API do Qianfan.
