Providers
تشيانفان
Qianfan هي منصة MaaS من Baidu: واجهة API موحّدة ومتوافقة مع OpenAI توجّه الطلبات إلى نماذج متعددة خلف نقطة نهاية واحدة ومفتاح API واحد. يوفّرها OpenClaw بوصفها Plugin خارجيًا رسميًا باسم @openclaw/qianfan-provider.
| الخاصية | القيمة |
|---|---|
| المزوّد | qianfan |
| المصادقة | QIANFAN_API_KEY |
| API | متوافقة مع OpenAI (openai-completions) |
| عنوان URL الأساسي | https://qianfan.baidubce.com/v2 |
| النموذج الافتراضي | qianfan/deepseek-v3.2 |
تثبيت Plugin
ثبّت Plugin الرسمي، ثم أعد تشغيل Gateway:
openclaw plugins install @openclaw/qianfan-provideropenclaw gateway restartبدء الاستخدام
إنشاء حساب Baidu Cloud
سجّل أو ادخل إلى حسابك في وحدة تحكم Qianfan، وتأكد من تمكين الوصول إلى API الخاصة بـ Qianfan.
إنشاء مفتاح API
أنشئ تطبيقًا جديدًا أو حدّد تطبيقًا موجودًا، ثم أنشئ مفتاح API. تستخدم مفاتيح Baidu Cloud التنسيق bce-v3/ALTAK-....
تشغيل الإعداد الأولي
openclaw onboard --auth-choice qianfan-api-keyتقرأ عمليات التشغيل غير التفاعلية المفتاح من --qianfan-api-key <key> أو
QIANFAN_API_KEY. يكتب الإعداد الأولي إعدادات المزوّد، ويضيف الاسم المستعار
QIANFAN للنموذج الافتراضي، ويعيّن qianfan/deepseek-v3.2
نموذجًا افتراضيًا عند عدم إعداد أي نموذج.
التحقق من توفر النموذج
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 القياسية، لكن قد لا تُمرَّر المعلمات الخاصة بالمزوّد.
استكشاف الأخطاء وإصلاحها
- تأكد من أن مفتاح API يبدأ بـ
bce-v3/ALTAK-وأن الوصول إلى API الخاصة بـ Qianfan مُمكّن في وحدة تحكم Baidu Cloud. - إذا لم تظهر النماذج في القائمة، فتأكد من تفعيل خدمة Qianfan في حسابك.
- لا تغيّر عنوان URL الأساسي إلا إذا كنت تستخدم نقطة نهاية مخصّصة أو خادمًا وسيطًا.
