Providers
Qianfan
Qianfan adalah platform MaaS Baidu: API terpadu yang kompatibel dengan OpenAI, yang merutekan permintaan ke banyak model melalui satu titik akhir dan kunci API. OpenClaw menyediakannya sebagai plugin eksternal resmi @openclaw/qianfan-provider.
| Properti | Nilai |
|---|---|
| Penyedia | qianfan |
| Autentikasi | QIANFAN_API_KEY |
| API | Kompatibel dengan OpenAI (openai-completions) |
| URL dasar | https://qianfan.baidubce.com/v2 |
| Model bawaan | qianfan/deepseek-v3.2 |
Instal plugin
Instal plugin resmi, lalu mulai ulang Gateway:
openclaw plugins install @openclaw/qianfan-provideropenclaw gateway restartMemulai
Buat akun Baidu Cloud
Daftar atau masuk di Konsol Qianfan dan pastikan akses API Qianfan telah diaktifkan.
Buat kunci API
Buat aplikasi baru atau pilih aplikasi yang sudah ada, lalu buat kunci API. Kunci Baidu Cloud menggunakan format bce-v3/ALTAK-....
Jalankan orientasi awal
openclaw onboard --auth-choice qianfan-api-keyProses noninteraktif membaca kunci dari --qianfan-api-key <key> atau
QIANFAN_API_KEY. Orientasi awal menulis konfigurasi penyedia, menambahkan
alias QIANFAN untuk model bawaan, dan menetapkan qianfan/deepseek-v3.2
sebagai model bawaan jika belum ada model yang dikonfigurasi.
Pastikan model tersedia
openclaw models list --provider qianfanKatalog bawaan
| Referensi model | Masukan | Konteks | Keluaran maks. | Penalaran | Catatan |
|---|---|---|---|---|---|
qianfan/deepseek-v3.2 |
teks | 98,304 | 32,768 | Ya | Model bawaan |
qianfan/ernie-5.0-thinking-preview |
teks, gambar | 119,000 | 64,000 | Ya | Multimodal |
Katalog ini bersifat statis; tidak ada penemuan model secara langsung.
Contoh konfigurasi
{ 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, }, ], }, }, },}Transpor dan kompatibilitas
Qianfan berjalan melalui jalur transpor yang kompatibel dengan OpenAI, bukan pembentukan permintaan OpenAI native. Fitur standar SDK OpenAI berfungsi, tetapi parameter khusus penyedia mungkin tidak diteruskan.
Pemecahan masalah
- Pastikan kunci API Anda diawali dengan
bce-v3/ALTAK-dan akses API Qianfan telah diaktifkan di konsol Baidu Cloud. - Jika model tidak tercantum, pastikan layanan Qianfan telah diaktifkan untuk akun Anda.
- Ubah URL dasar hanya jika Anda menggunakan titik akhir atau proksi khusus.
