Providers
Qianfan
Qianfan is Baidu's MaaS-platform: een uniforme, met OpenAI compatibele API die aanvragen via één eindpunt en één API-sleutel naar vele modellen routeert. OpenClaw levert deze als de officiële externe Plugin @openclaw/qianfan-provider.
| Eigenschap | Waarde |
|---|---|
| Provider | qianfan |
| Authenticatie | QIANFAN_API_KEY |
| API | OpenAI-compatibel (openai-completions) |
| Basis-URL | https://qianfan.baidubce.com/v2 |
| Standaardmodel | qianfan/deepseek-v3.2 |
Plugin installeren
Installeer de officiële Plugin en start daarna de Gateway opnieuw:
openclaw plugins install @openclaw/qianfan-provideropenclaw gateway restartAan de slag
Een Baidu Cloud-account maken
Registreer je of meld je aan bij de Qianfan-console en zorg dat toegang tot de Qianfan-API is ingeschakeld.
Een API-sleutel genereren
Maak een nieuwe toepassing of selecteer een bestaande en genereer vervolgens een API-sleutel. Baidu Cloud-sleutels gebruiken de indeling bce-v3/ALTAK-....
Onboarding uitvoeren
openclaw onboard --auth-choice qianfan-api-keyNiet-interactieve uitvoeringen lezen de sleutel uit --qianfan-api-key <key> of
QIANFAN_API_KEY. Onboarding schrijft de providerconfiguratie, voegt de
alias QIANFAN voor het standaardmodel toe en stelt qianfan/deepseek-v3.2
in als standaardmodel wanneer er geen model is geconfigureerd.
Controleren of het model beschikbaar is
openclaw models list --provider qianfanIngebouwde catalogus
| Modelreferentie | Invoer | Context | Maximale uitvoer | Redeneren | Opmerkingen |
|---|---|---|---|---|---|
qianfan/deepseek-v3.2 |
tekst | 98,304 | 32,768 | Ja | Standaardmodel |
qianfan/ernie-5.0-thinking-preview |
tekst, afbeelding | 119,000 | 64,000 | Ja | Multimodaal |
De catalogus is statisch; modellen worden niet live gedetecteerd.
Configuratievoorbeeld
{ 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, }, ], }, }, },}Transport en compatibiliteit
Qianfan werkt via het met OpenAI compatibele transportpad en niet via de systeemeigen vormgeving van OpenAI-aanvragen. Standaardfuncties van de OpenAI-SDK werken, maar providerspecifieke parameters worden mogelijk niet doorgestuurd.
Problemen oplossen
- Zorg dat je API-sleutel begint met
bce-v3/ALTAK-en dat toegang tot de Qianfan-API is ingeschakeld in de Baidu Cloud-console. - Als modellen niet worden weergegeven, controleer dan of de Qianfan-service voor je account is geactiveerd.
- Wijzig de basis-URL alleen als je een aangepast eindpunt of een aangepaste proxy gebruikt.
