Providers
آتشبازی
Fireworks مدلهای open-weight و مدلهای مسیریابیشده را از طریق یک API سازگار با OpenAI ارائه میکند. Plugin رسمی ارائهدهنده Fireworks را نصب کنید تا از دو مدل Kimi از پیش فهرستشده و هر مدل یا شناسه روتر Fireworks در زمان اجرا استفاده کنید.
| ویژگی | مقدار |
|---|---|
| شناسه ارائهدهنده | fireworks (نام مستعار: fireworks-ai) |
| بسته | @openclaw/fireworks-provider |
| متغیر محیطی احراز هویت | FIREWORKS_API_KEY |
| پرچم راهاندازی اولیه | --auth-choice fireworks-api-key |
| پرچم مستقیم CLI | --fireworks-api-key <key> |
| API | سازگار با OpenAI (openai-completions) |
| URL پایه | https://api.fireworks.ai/inference/v1 |
| مدل پیشفرض | fireworks/accounts/fireworks/routers/kimi-k2p5-turbo |
| نام مستعار پیشفرض | Kimi K2.5 Turbo |
شروع به کار
Install the plugin
openclaw plugins install @openclaw/fireworks-providerSet the Fireworks API key
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.5 Turbo با Fire Pass را بهعنوان مدل پیشفرض تنظیم میکند.
Verify the model is available
openclaw models list --provider fireworksفهرست باید شامل Kimi K2.6 و Kimi K2.5 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-k2p5-turbo |
Kimi K2.5 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>", }, }, },}How model id prefixing works
هر ارجاع مدل Fireworks در OpenClaw با fireworks/ شروع میشود و سپس شناسه دقیق یا مسیر روتر از پلتفرم Fireworks میآید. برای مثال:
- مدل روتر:
fireworks/accounts/fireworks/routers/kimi-k2p5-turbo - مدل مستقیم:
fireworks/accounts/fireworks/models/<model-name>
OpenClaw هنگام ساخت درخواست API، پیشوند fireworks/ را حذف میکند و مسیر باقیمانده را بهعنوان فیلد model سازگار با OpenAI به endpoint Fireworks میفرستد.
Why thinking is forced off for Kimi
اگر درخواست دارای پارامترهای reasoning_* باشد، Fireworks K2.6 خطای 400 برمیگرداند، با اینکه Kimi از طریق API خود Moonshot از تفکر پشتیبانی میکند. سیاست ارائهدهنده (extensions/fireworks/thinking-policy.ts) برای شناسههای مدل Kimi فقط سطح تفکر off را اعلام میکند، بنابراین جابهجاییهای دستی /think و سطحهای سیاست ارائهدهنده با قرارداد زمان اجرا همسو میمانند.
برای استفاده سرتاسری از استدلال Kimi، ارائهدهنده Moonshot را پیکربندی کنید و همان مدل را از طریق آن مسیریابی کنید.
Environment availability for the daemon
اگر Gateway بهصورت یک سرویس مدیریتشده اجرا میشود (launchd، systemd، Docker)، کلید Fireworks باید برای همان فرایند قابل مشاهده باشد، نه فقط برای shell تعاملی شما.
در macOS، openclaw gateway install از قبل ~/.openclaw/.env را به فایل محیط LaunchAgent وصل میکند. پس از چرخاندن کلید، نصب را دوباره اجرا کنید (یا openclaw doctor --fix را اجرا کنید).
