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 :

openclaw plugins install @openclaw/qianfan-provider
openclaw 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

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

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.

Vous devez remplacer models.providers.qianfan uniquement si vous avez besoin d’une URL de base personnalisée ou de métadonnées de modèle personnalisées.

Exemple de configuration

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

Les références de modèle utilisent le préfixe qianfan/ (par exemple qianfan/deepseek-v3.2).

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.

Overview

Concepts and configuration

Providers

Installer le Plugin

Prise en main

Catalogue intégré

Exemple de configuration

Voir aussi

Sélection du modèle

Référence de configuration

Configuration de l’agent

Documentation de l’API Qianfan

​Installer le Plugin

​Prise en main

​Catalogue intégré

​Exemple de configuration

​Voir aussi

Sélection du modèle

Référence de configuration

Configuration de l’agent

Documentation de l’API Qianfan

Installer le Plugin

Prise en main

Catalogue intégré

Exemple de configuration

Voir aussi