Providers
Qianfan
Qianfan is Baidu's MaaS-platform: een uniforme, OpenAI-compatibele API die aanvragen via één endpoint en API-sleutel naar verschillende modellen doorstuurt. 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 aanmaken
Registreer u of meld u aan bij de Qianfan Console en zorg dat API-toegang tot Qianfan is ingeschakeld.
Een API-sleutel genereren
Maak een nieuwe toepassing aan of selecteer een bestaande toepassing en genereer vervolgens een API-sleutel. Sleutels van Baidu Cloud gebruiken de indeling bce-v3/ALTAK-....
De onboarding uitvoeren
openclaw onboard --auth-choice qianfan-api-keyNiet-interactieve uitvoeringen lezen de sleutel uit --qianfan-api-key <key> of
QIANFAN_API_KEY. De 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, beeld | 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 gebruikt het OpenAI-compatibele transportpad en niet de systeemeigen vormgeving van OpenAI-aanvragen. Standaardfuncties van de OpenAI SDK werken, maar providerspecifieke parameters worden mogelijk niet doorgestuurd.
Problemen oplossen
- Zorg dat uw API-sleutel begint met
bce-v3/ALTAK-en dat API-toegang tot Qianfan is ingeschakeld in de Baidu Cloud-console. - Als modellen niet worden weergegeven, controleert u of de Qianfan-service voor uw account is geactiveerd.
- Wijzig de basis-URL alleen als u een aangepast endpoint of een aangepaste proxy gebruikt.
