Providers
Qianfan
Qianfan هي منصة MaaS من Baidu، وتوفر API موحدًا يوجّه الطلبات إلى نماذج عديدة خلف نقطة نهاية واحدة ومفتاح API واحد. وهي متوافقة مع OpenAI، لذلك تعمل معظم OpenAI SDKs عند تبديل عنوان URL الأساسي.
| الخاصية | القيمة |
|---|---|
| المزوّد | qianfan |
| المصادقة | QIANFAN_API_KEY |
| API | متوافق مع OpenAI |
| عنوان URL الأساسي | https://qianfan.baidubce.com/v2 |
تثبيت Plugin
ثبّت Plugin الرسمي، ثم أعد تشغيل Gateway:
openclaw plugins install @openclaw/qianfan-provideropenclaw gateway restartالبدء
إنشاء حساب Baidu Cloud
سجّل أو ادخل في وحدة تحكم Qianfan وتأكد من تفعيل وصول Qianfan API لديك.
إنشاء مفتاح API
أنشئ تطبيقًا جديدًا أو اختر تطبيقًا موجودًا، ثم أنشئ مفتاح API. تنسيق المفتاح هو bce-v3/ALTAK-....
تشغيل الإعداد الأولي
openclaw onboard --auth-choice qianfan-api-keyالتحقق من توفر النموذج
openclaw models list --provider qianfanالكتالوج المدمج
| مرجع النموذج | الإدخال | السياق | الحد الأقصى للإخراج | الاستدلال | ملاحظات |
|---|---|---|---|---|---|
qianfan/deepseek-v3.2 |
نص | 98,304 | 32,768 | نعم | النموذج الافتراضي |
qianfan/ernie-5.0-thinking-preview |
نص، صورة | 119,000 | 64,000 | نعم | متعدد الوسائط |
مثال إعداد
{ 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, }, ], }, }, },}النقل والتوافق
يعمل Qianfan عبر مسار نقل متوافق مع OpenAI، وليس عبر تشكيل طلبات OpenAI الأصلية. يعني هذا أن ميزات OpenAI SDK القياسية تعمل، لكن قد لا تُمرَّر المعلمات الخاصة بالمزوّد.
الكتالوج والتجاوزات
يتضمن الكتالوج الثابت حاليًا deepseek-v3.2 وernie-5.0-thinking-preview. أضف أو تجاوز models.providers.qianfan فقط عندما تحتاج إلى عنوان URL أساسي مخصص أو بيانات تعريف للنموذج.
استكشاف الأخطاء وإصلاحها
- تأكد من أن مفتاح API لديك يبدأ بـ
bce-v3/ALTAK-وأن وصول Qianfan API مفعّل في وحدة تحكم Baidu Cloud. - إذا لم تكن النماذج مدرجة، فتأكد من تفعيل خدمة Qianfan في حسابك.
- عنوان URL الأساسي الافتراضي هو
https://qianfan.baidubce.com/v2. لا تغيّره إلا إذا كنت تستخدم نقطة نهاية مخصصة أو وكيلًا.
