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-provider
openclaw gateway restart

Aan 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-key

Niet-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 qianfan

Ingebouwde 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.

Je hoeft models.providers.qianfan alleen te overschrijven wanneer je een aangepaste basis-URL of aangepaste modelmetagegevens nodig hebt.

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

Modelreferenties gebruiken het voorvoegsel qianfan/ (bijvoorbeeld qianfan/deepseek-v3.2).

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.

Gerelateerd

Modelselectie

Providers, modelreferenties en failovergedrag kiezen.

Configuratiereferentie

Volledige OpenClaw-configuratiereferentie.

Agent instellen

Standaardinstellingen en modeltoewijzingen voor agents configureren.

Qianfan-API-documentatie

Officiële documentatie voor de Qianfan-API.

Overview

Concepts and configuration

Providers

Plugin installeren

Aan de slag

Ingebouwde catalogus

Configuratievoorbeeld

Gerelateerd

Modelselectie

Configuratiereferentie

Agent instellen

Qianfan-API-documentatie

​Plugin installeren

​Aan de slag

​Ingebouwde catalogus

​Configuratievoorbeeld

​Gerelateerd

Modelselectie

Configuratiereferentie

Agent instellen

Qianfan-API-documentatie

Plugin installeren

Aan de slag

Ingebouwde catalogus

Configuratievoorbeeld

Gerelateerd