Providers

Qianfan

Qianfan ist Baidus MaaS-Plattform: eine einheitliche, OpenAI-kompatible API, die Anfragen über einen einzigen Endpunkt und API-Schlüssel an zahlreiche Modelle weiterleitet. OpenClaw stellt sie als offizielles externes Plugin @openclaw/qianfan-provider bereit.

Eigenschaft	Wert
Provider	`qianfan`
Authentifizierung	`QIANFAN_API_KEY`
API	OpenAI-kompatibel (`openai-completions`)
Basis-URL	`https://qianfan.baidubce.com/v2`
Standardmodell	`qianfan/deepseek-v3.2`

Plugin installieren

Installieren Sie das offizielle Plugin und starten Sie anschließend den Gateway neu:

bash

openclaw plugins install @openclaw/qianfan-provideropenclaw gateway restart

Erste Schritte

Ein Baidu-Cloud-Konto erstellen

Registrieren Sie sich in der Qianfan-Konsole oder melden Sie sich dort an und stellen Sie sicher, dass der Qianfan-API-Zugriff für Sie aktiviert ist.

Einen API-Schlüssel generieren

Erstellen Sie eine neue Anwendung oder wählen Sie eine vorhandene aus und generieren Sie anschließend einen API-Schlüssel. Baidu-Cloud-Schlüssel verwenden das Format bce-v3/ALTAK-....

Onboarding ausführen

bash

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

Nicht interaktive Ausführungen lesen den Schlüssel aus --qianfan-api-key <key> oder QIANFAN_API_KEY. Das Onboarding schreibt die Provider-Konfiguration, fügt den Alias QIANFAN für das Standardmodell hinzu und legt qianfan/deepseek-v3.2 als Standardmodell fest, wenn keines konfiguriert ist.

Verfügbarkeit des Modells überprüfen

bash

openclaw models list --provider qianfan

Integrierter Katalog

Modellreferenz	Eingabe	Kontext	Maximale Ausgabe	Reasoning	Hinweise
`qianfan/deepseek-v3.2`	Text	98,304	32,768	Ja	Standardmodell
`qianfan/ernie-5.0-thinking-preview`	Text, Bild	119,000	64,000	Ja	Multimodal

Der Katalog ist statisch; es gibt keine Live-Modellerkennung.

Konfigurationsbeispiel

json5

{  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 und Kompatibilität

Qianfan verwendet den OpenAI-kompatiblen Transportpfad und nicht die native Formgebung von OpenAI-Anfragen. Standardfunktionen des OpenAI SDK funktionieren, providerspezifische Parameter werden jedoch möglicherweise nicht weitergeleitet.

Fehlerbehebung

Stellen Sie sicher, dass Ihr API-Schlüssel mit bce-v3/ALTAK- beginnt und der Qianfan-API-Zugriff in der Baidu-Cloud-Konsole aktiviert ist.
Wenn keine Modelle aufgeführt werden, vergewissern Sie sich, dass der Qianfan-Dienst für Ihr Konto aktiviert ist.
Ändern Sie die Basis-URL nur, wenn Sie einen benutzerdefinierten Endpunkt oder Proxy verwenden.

Auf dieser Seite

Qianfan

Plugin installieren

Erste Schritte

Ein Baidu-Cloud-Konto erstellen

Einen API-Schlüssel generieren

Onboarding ausführen

Verfügbarkeit des Modells überprüfen

Integrierter Katalog

Konfigurationsbeispiel

Verwandte Themen

Molty