Providers
چیانفان
Qianfan پلتفرم MaaS شرکت Baidu است: یک API یکپارچه و سازگار با OpenAI که درخواستها را از طریق یک نقطه پایانی و کلید API واحد به مدلهای متعدد هدایت میکند. OpenClaw آن را بهعنوان Plugin خارجی رسمی @openclaw/qianfan-provider ارائه میکند.
| ویژگی | مقدار |
|---|---|
| ارائهدهنده | qianfan |
| احراز هویت | QIANFAN_API_KEY |
| API | سازگار با OpenAI (openai-completions) |
| نشانی پایه | 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. قابلیتهای استاندارد SDK مربوط به OpenAI کار میکنند، اما ممکن است پارامترهای مختص ارائهدهنده ارسال نشوند.
عیبیابی
- مطمئن شوید کلید API شما با
bce-v3/ALTAK-آغاز میشود و دسترسی آن به API سرویس Qianfan در کنسول Baidu Cloud فعال است. - اگر مدلها فهرست نمیشوند، تأیید کنید سرویس Qianfan برای حساب شما فعال شده است.
- نشانی پایه را فقط در صورت استفاده از نقطه پایانی یا پراکسی سفارشی تغییر دهید.
