Qianfan

Qianfan è la piattaforma MaaS di Baidu: un’API unificata e compatibile con OpenAI che instrada le richieste a numerosi modelli tramite un unico endpoint e una sola chiave API. OpenClaw la distribuisce come Plugin esterno ufficiale @openclaw/qianfan-provider.

Proprietà	Valore
Provider	`qianfan`
Autenticazione	`QIANFAN_API_KEY`
API	Compatibile con OpenAI (`openai-completions`)
URL di base	`https://qianfan.baidubce.com/v2`
Modello predefinito	`qianfan/deepseek-v3.2`

Installare il Plugin

Installa il Plugin ufficiale, quindi riavvia il Gateway:

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

Guida introduttiva

Creare un account Baidu Cloud

Registrati o accedi alla console Qianfan e assicurati che l’accesso all’API Qianfan sia abilitato.

Generare una chiave API

Crea una nuova applicazione o selezionane una esistente, quindi genera una chiave API. Le chiavi Baidu Cloud utilizzano il formato bce-v3/ALTAK-....

Eseguire la configurazione iniziale

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

Le esecuzioni non interattive leggono la chiave da --qianfan-api-key <key> o QIANFAN_API_KEY. La configurazione iniziale scrive la configurazione del provider, aggiunge l’alias QIANFAN per il modello predefinito e imposta qianfan/deepseek-v3.2 come modello predefinito quando non ne è configurato alcuno.

Verificare che il modello sia disponibile

openclaw models list --provider qianfan

Catalogo integrato

Riferimento del modello	Input	Contesto	Output massimo	Ragionamento	Note
`qianfan/deepseek-v3.2`	testo	98,304	32,768	Sì	Modello predefinito
`qianfan/ernie-5.0-thinking-preview`	testo, immagine	119,000	64,000	Sì	Multimodale

Il catalogo è statico; non è disponibile il rilevamento dei modelli in tempo reale.

Devi sovrascrivere models.providers.qianfan solo se ti occorrono un URL di base personalizzato o metadati del modello personalizzati.

Esempio di configurazione

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

I riferimenti dei modelli utilizzano il prefisso qianfan/ (ad esempio qianfan/deepseek-v3.2).

Trasporto e compatibilità

Qianfan utilizza il percorso di trasporto compatibile con OpenAI, non la struttura nativa delle richieste OpenAI. Le funzionalità standard dell’SDK OpenAI sono supportate, ma i parametri specifici del provider potrebbero non essere inoltrati.

Risoluzione dei problemi

Assicurati che la chiave API inizi con bce-v3/ALTAK- e che l’accesso all’API Qianfan sia abilitato nella console Baidu Cloud.
Se i modelli non sono elencati, verifica che il servizio Qianfan sia attivato per il tuo account.
Modifica l’URL di base solo se utilizzi un endpoint personalizzato o un proxy.

Contenuti correlati

Selezione del modello

Scelta dei provider, dei riferimenti dei modelli e del comportamento di failover.

Riferimento della configurazione

Riferimento completo della configurazione di OpenClaw.

Configurazione dell'agente

Configurazione delle impostazioni predefinite degli agenti e delle assegnazioni dei modelli.

Documentazione dell'API Qianfan

Documentazione ufficiale dell’API Qianfan.

Overview

Concepts and configuration

Providers

Installare il Plugin

Guida introduttiva

Catalogo integrato

Esempio di configurazione

Contenuti correlati

Selezione del modello

Riferimento della configurazione

Configurazione dell'agente

Documentazione dell'API Qianfan

​Installare il Plugin

​Guida introduttiva

​Catalogo integrato

​Esempio di configurazione

​Contenuti correlati

Selezione del modello

Riferimento della configurazione

Configurazione dell'agente

Documentazione dell'API Qianfan

Installare il Plugin

Guida introduttiva

Catalogo integrato

Esempio di configurazione

Contenuti correlati