Providers
Fireworks
Fireworks مدلهای با وزنهای باز و مسیریابیشده را از طریق یک API سازگار با OpenAI ارائه میکند. برای استفاده از دو مدل Kimi ازپیشفهرستشده و هر شناسه مدل یا مسیریاب Fireworks در زمان اجرا، Plugin رسمی ارائهدهنده Fireworks را نصب کنید.
| ویژگی | مقدار |
|---|---|
| شناسه ارائهدهنده | fireworks (نام مستعار: fireworks-ai) |
| بسته | @openclaw/fireworks-provider |
| متغیر محیطی احراز هویت | FIREWORKS_API_KEY |
| پرچم راهاندازی اولیه | --auth-choice fireworks-api-key |
| پرچم مستقیم CLI | --fireworks-api-key <key> |
| API | سازگار با OpenAI (openai-completions) |
| نشانی پایه | https://api.fireworks.ai/inference/v1 |
| مدل پیشفرض | fireworks/accounts/fireworks/routers/kimi-k2p6-turbo |
| نام مستعار پیشفرض | Kimi K2.6 Turbo |
شروع به کار
نصب Plugin
openclaw plugins install @openclaw/fireworks-providerتنظیم کلید API مربوط به Fireworks
openclaw onboard --auth-choice fireworks-api-keyopenclaw onboard --non-interactive \--auth-choice fireworks-api-key \--fireworks-api-key "$FIREWORKS_API_KEY"export FIREWORKS_API_KEY=fw-...راهاندازی اولیه، کلید را برای ارائهدهنده fireworks در پروفایلهای احراز هویت شما ذخیره میکند و مسیریاب Kimi K2.6 Turbo با Fire Pass را بهعنوان مدل پیشفرض تنظیم میکند.
اطمینان از دردسترسبودن مدل
openclaw models list --provider fireworksفهرست باید شامل Kimi K2.6 و Kimi K2.6 Turbo (Fire Pass) باشد. اگر FIREWORKS_API_KEY حلنشده باشد، openclaw models status --json اعتبارنامه مفقود را در بخش auth.unusableProfiles گزارش میکند.
راهاندازی غیرتعاملی
برای نصبهای اسکریپتی یا CI، همهچیز را در خط فرمان وارد کنید:
openclaw onboard --non-interactive \ --mode local \ --auth-choice fireworks-api-key \ --fireworks-api-key "$FIREWORKS_API_KEY" \ --skip-health \ --accept-riskکاتالوگ داخلی
| ارجاع مدل | نام | ورودی | زمینه | حداکثر خروجی | تفکر |
|---|---|---|---|---|---|
fireworks/accounts/fireworks/models/kimi-k2p6 |
Kimi K2.6 | متن + تصویر | 262,144 | 262,144 | اجباراً خاموش |
fireworks/accounts/fireworks/routers/kimi-k2p6-turbo |
Kimi K2.6 Turbo (Fire Pass) | متن + تصویر | 256,000 | 256,000 | اجباراً خاموش (پیشفرض) |
شناسههای سفارشی مدل Fireworks
OpenClaw در زمان اجرا هر شناسه مدل یا مسیریاب Fireworks را میپذیرد. از شناسه دقیق نمایشدادهشده در Fireworks استفاده کنید و پیشوند fireworks/ را به آن بیفزایید. تفکیک پویا، الگوی Fire Pass را شبیهسازی میکند (ورودی متن + تصویر، API سازگار با OpenAI و هزینه پیشفرض صفر) و وقتی شناسه با الگوی Kimi مطابقت داشته باشد، تفکر را بهطور خودکار غیرفعال میکند. شناسههای پویای GLM فقطمتنی علامتگذاری میشوند، مگر آنکه یک ورودی مدل سفارشی با ورودی تصویر پیکربندی کنید.
{ agents: { defaults: { model: { primary: "fireworks/accounts/fireworks/models/<your-model-id>", }, }, },}نحوه کار پیشوندگذاری شناسه مدل
هر ارجاع مدل Fireworks در OpenClaw با fireworks/ آغاز میشود و پس از آن، شناسه دقیق یا مسیر مسیریاب از پلتفرم Fireworks میآید. برای مثال:
- مدل مسیریاب:
fireworks/accounts/fireworks/routers/kimi-k2p6-turbo - مدل مستقیم:
fireworks/accounts/fireworks/models/<model-name>
OpenClaw هنگام ساخت درخواست API، پیشوند fireworks/ را حذف میکند و مسیر باقیمانده را بهعنوان فیلد سازگار با OpenAI یعنی model به نقطه پایانی Fireworks میفرستد.
چرا تفکر برای Kimi اجباراً خاموش است
Fireworks مدل Kimi را بدون کانال استدلال جداگانه ارائه میکند؛ بنابراین زنجیره فکر ممکن است در جریان قابلمشاهده content ظاهر شود. OpenClaw در هر درخواست Kimi به Fireworks، مقدار thinking: { type: "disabled" } را ارسال میکند و reasoning، reasoning_effort و reasoningEffort را از محموله حذف میکند (extensions/fireworks/stream.ts). خطمشی ارائهدهنده (extensions/fireworks/thinking-policy.ts) برای شناسههای مدل Kimi فقط سطح تفکر off را اعلام میکند؛ بنابراین تغییرات دستی /think و سطوح خطمشی ارائهدهنده با قرارداد زمان اجرا همراستا میمانند.
برای استفاده سرتاسری از استدلال Kimi، ارائهدهنده Moonshot را پیکربندی و همان مدل را از طریق آن مسیریابی کنید.
دردسترسبودن محیط برای دیمن
اگر Gateway بهصورت یک سرویس مدیریتشده (launchd، systemd، Docker) اجرا میشود، کلید Fireworks باید برای آن فرایند قابلمشاهده باشد، نه فقط برای پوسته تعاملی شما.
OpenClaw هنگام بارگذاری پیکربندی، ~/.openclaw/.env را بارگذاری میکند؛ بنابراین کلیدهای ذخیرهشده در آن، در هر پلتفرمی به سرویسهای مدیریتشده Gateway میرسند. پس از تعویض کلید، Gateway را راهاندازی مجدد کنید (یا openclaw doctor --fix را دوباره اجرا کنید).
