Providers
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-provideropenclaw gateway restartGuida 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-keyLe 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 qianfanCatalogo 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.
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, }, ], }, }, },}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
Scelta dei provider, dei riferimenti dei modelli e del comportamento di failover.
Riferimento completo della configurazione di OpenClaw.
Configurazione delle impostazioni predefinite degli agenti e delle assegnazioni dei modelli.
Documentazione ufficiale dell'API Qianfan.
