Providers
Qianfan
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 Console ثبتنام یا وارد شوید و مطمئن شوید دسترسی 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 برای حساب شما فعال شده است.
- نشانی پایه را فقط در صورت استفاده از نقطه پایانی یا پراکسی سفارشی تغییر دهید.
