Providers
Qianfan
Qianfan, Baidu'nun MaaS platformudur: istekleri tek bir uç nokta ve API anahtarı üzerinden arka plandaki birçok modele yönlendiren, birleşik ve OpenAI uyumlu bir API'dir. OpenClaw, bunu resmi harici plugin @openclaw/qianfan-provider olarak sunar.
| Özellik | Değer |
|---|---|
| Sağlayıcı | qianfan |
| Kimlik doğrulama | QIANFAN_API_KEY |
| API | OpenAI uyumlu (openai-completions) |
| Temel URL | https://qianfan.baidubce.com/v2 |
| Varsayılan model | qianfan/deepseek-v3.2 |
Plugin'i yükleme
Resmi plugin'i yükleyin, ardından Gateway'i yeniden başlatın:
openclaw plugins install @openclaw/qianfan-provideropenclaw gateway restartBaşlarken
Baidu Cloud hesabı oluşturma
Qianfan Console üzerinden kaydolun veya oturum açın ve Qianfan API erişiminizin etkinleştirildiğinden emin olun.
API anahtarı oluşturma
Yeni bir uygulama oluşturun veya mevcut bir uygulamayı seçin, ardından bir API anahtarı oluşturun. Baidu Cloud anahtarları bce-v3/ALTAK-... biçimini kullanır.
İlk kurulumu çalıştırma
openclaw onboard --auth-choice qianfan-api-keyEtkileşimsiz çalıştırmalar anahtarı --qianfan-api-key <key> veya
QIANFAN_API_KEY üzerinden okur. İlk kurulum, sağlayıcı yapılandırmasını yazar, varsayılan model için
QIANFAN diğer adını ekler ve hiçbir model yapılandırılmamışsa
qianfan/deepseek-v3.2 değerini varsayılan model olarak ayarlar.
Modelin kullanılabilir olduğunu doğrulama
openclaw models list --provider qianfanYerleşik katalog
| Model referansı | Girdi | Bağlam | En fazla çıktı | Akıl yürütme | Notlar |
|---|---|---|---|---|---|
qianfan/deepseek-v3.2 |
metin | 98,304 | 32,768 | Evet | Varsayılan model |
qianfan/ernie-5.0-thinking-preview |
metin, görüntü | 119,000 | 64,000 | Evet | Çok modlu |
Katalog statiktir; canlı model keşfi yoktur.
Yapılandırma örneği
{ 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, }, ], }, }, },}Aktarım ve uyumluluk
Qianfan, yerel OpenAI istek biçimlendirmesi yerine OpenAI uyumlu aktarım yolu üzerinden çalışır. Standart OpenAI SDK özellikleri çalışır ancak sağlayıcıya özgü parametreler iletilmeyebilir.
Sorun giderme
- API anahtarınızın
bce-v3/ALTAK-ile başladığından ve Baidu Cloud konsolunda Qianfan API erişiminin etkinleştirildiğinden emin olun. - Modeller listelenmiyorsa hesabınızda Qianfan hizmetinin etkinleştirildiğini doğrulayın.
- Temel URL'yi yalnızca özel bir uç nokta veya proxy kullanıyorsanız değiştirin.
