OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

Qianfan

Qianfan est la plateforme MaaS de Baidu : une API unifiée compatible avec OpenAI qui achemine les requêtes vers de nombreux modèles derrière un point de terminaison et une clé API uniques. OpenClaw la fournit sous la forme du Plugin externe officiel @openclaw/qianfan-provider.

Propriété Valeur
Fournisseur qianfan
Authentification QIANFAN_API_KEY
API Compatible avec OpenAI (openai-completions)
URL de base https://qianfan.baidubce.com/v2
Modèle par défaut qianfan/deepseek-v3.2

Installer le Plugin

Installez le Plugin officiel, puis redémarrez le Gateway :

bash
openclaw plugins install @openclaw/qianfan-provideropenclaw gateway restart

Prise en main

  • Créer un compte Baidu Cloud

    Inscrivez-vous ou connectez-vous à la console Qianfan, puis vérifiez que l’accès à l’API Qianfan est activé.

  • Générer une clé API

    Créez une nouvelle application ou sélectionnez-en une existante, puis générez une clé API. Les clés Baidu Cloud utilisent le format bce-v3/ALTAK-....

  • Exécuter la configuration initiale

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

    Les exécutions non interactives lisent la clé depuis --qianfan-api-key <key> ou QIANFAN_API_KEY. La configuration initiale écrit la configuration du fournisseur, ajoute l’alias QIANFAN au modèle par défaut et définit qianfan/deepseek-v3.2 comme modèle par défaut lorsqu’aucun modèle n’est configuré.

  • Vérifier que le modèle est disponible

    bash
    openclaw models list --provider qianfan

    • Catalogue intégré

    Référence du modèle Entrée Contexte Sortie maximale Raisonnement Remarques
    qianfan/deepseek-v3.2 texte 98,304 32,768 Oui Modèle par défaut
    qianfan/ernie-5.0-thinking-preview texte, image 119,000 64,000 Oui Multimodal

    Le catalogue est statique ; aucune découverte des modèles en temps réel n’est effectuée.

    Exemple de configuration

    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 et compatibilité

    Qianfan utilise le chemin de transport compatible avec OpenAI, et non le formatage natif des requêtes OpenAI. Les fonctionnalités standard du SDK OpenAI fonctionnent, mais les paramètres propres au fournisseur peuvent ne pas être transmis.

    Dépannage
    • Vérifiez que votre clé API commence par bce-v3/ALTAK- et que l’accès à l’API Qianfan est activé dans la console Baidu Cloud.
    • Si les modèles ne sont pas répertoriés, vérifiez que le service Qianfan est activé pour votre compte.
    • Ne modifiez l’URL de base que si vous utilisez un point de terminaison personnalisé ou un proxy.

    Voir aussi

    Sélection du modèle

    Choix des fournisseurs, des références de modèle et du comportement de basculement.
    Référence de configuration

    Référence complète de la configuration d’OpenClaw.
    Configuration de l’agent

    Configuration des valeurs par défaut de l’agent et de l’attribution des modèles.
    Documentation de l’API Qianfan

    Documentation officielle de l’API Qianfan.
    Was this useful?
    On this page

    On this page