Providers
Qianfan
Qianfan est la plateforme MaaS de Baidu, fournissant une API unifiée qui achemine les requêtes vers de nombreux modèles derrière un seul point de terminaison et une clé API unique. Elle est compatible OpenAI, donc la plupart des SDK OpenAI fonctionnent en changeant l’URL de base.
| Propriété | Valeur |
|---|---|
| Fournisseur | qianfan |
| Authentification | QIANFAN_API_KEY |
| API | Compatible OpenAI |
| URL de base | https://qianfan.baidubce.com/v2 |
Installer le Plugin
Installez le Plugin officiel, puis redémarrez Gateway :
openclaw plugins install @openclaw/qianfan-provideropenclaw gateway restartPremiers pas
Create a Baidu Cloud account
Inscrivez-vous ou connectez-vous à la console Qianfan et assurez-vous que l’accès à l’API Qianfan est activé.
Generate an API key
Créez une nouvelle application ou sélectionnez-en une existante, puis générez une clé API. Le format de la clé est bce-v3/ALTAK-....
Run onboarding
openclaw onboard --auth-choice qianfan-api-keyVerify the model is available
openclaw models list --provider qianfanCatalogue intégré
| Référence du modèle | Entrée | Contexte | Sortie max. | Raisonnement | Notes |
|---|---|---|---|---|---|
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 |
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, }, ], }, }, },}Transport and compatibility
Qianfan utilise le chemin de transport compatible OpenAI, et non la mise en forme native des requêtes OpenAI. Cela signifie que les fonctionnalités standard des SDK OpenAI fonctionnent, mais que les paramètres propres au fournisseur peuvent ne pas être transmis.
Catalog and overrides
Le catalogue statique inclut actuellement deepseek-v3.2 et ernie-5.0-thinking-preview. Ajoutez ou remplacez models.providers.qianfan uniquement lorsque vous avez besoin d’une URL de base personnalisée ou de métadonnées de modèle.
Troubleshooting
- Assurez-vous 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 listés, vérifiez que le service Qianfan est activé pour votre compte.
- L’URL de base par défaut est
https://qianfan.baidubce.com/v2. Ne la modifiez que si vous utilisez un point de terminaison personnalisé ou un proxy.
Associés
Choisir les fournisseurs, les références de modèle et le comportement de basculement.
Référence complète de configuration OpenClaw.
Configurer les valeurs par défaut des agents et les affectations de modèles.
Documentation officielle de l’API Qianfan.
