Providers
الألعاب النارية
تتيح Fireworks نماذج مفتوحة الأوزان ونماذج موجّهة عبر واجهة 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 |
بدء الاستخدام
تثبيت Plugin
openclaw plugins install @openclaw/fireworks-providerتعيين مفتاح Fireworks API
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 بوصفه النموذج الافتراضي.
التحقق من توفر النموذج
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>", }, }, },}كيفية عمل إضافة بادئة إلى معرّف النموذج
يبدأ كل مرجع لنموذج Fireworks في OpenClaw بالبادئة fireworks/ متبوعة بالمعرّف الدقيق أو مسار الموجّه من منصة Fireworks. على سبيل المثال:
- نموذج موجّه:
fireworks/accounts/fireworks/routers/kimi-k2p5-turbo - نموذج مباشر:
fireworks/accounts/fireworks/models/<model-name>
يزيل OpenClaw البادئة fireworks/ عند إنشاء طلب API، ويرسل المسار المتبقي إلى نقطة نهاية Fireworks بوصفه حقل model المتوافق مع OpenAI.
سبب تعطيل التفكير إجباريًا لنماذج Kimi
تقدّم Fireworks نموذج Kimi من دون قناة استدلال منفصلة، لذلك قد يظهر تسلسل الأفكار في تدفق content المرئي. يرسل OpenClaw في كل طلب Kimi عبر Fireworks القيمة thinking: { type: "disabled" }، ويزيل reasoning وreasoning_effort وreasoningEffort من الحمولة (extensions/fireworks/stream.ts). لا تعلن سياسة المزوّد (extensions/fireworks/thinking-policy.ts) سوى مستوى التفكير off لمعرّفات نماذج Kimi، كي تظل مفاتيح التبديل اليدوية /think وواجهات سياسة المزوّد متوافقة مع عقد وقت التشغيل.
لاستخدام استدلال Kimi من البداية إلى النهاية، اضبط مزوّد Moonshot ووجّه النموذج نفسه عبره.
توفر البيئة للعملية الخفية
إذا كان Gateway يعمل بوصفه خدمة مُدارة (launchd أو systemd أو Docker)، فيجب أن يكون مفتاح Fireworks مرئيًا لتلك العملية، وليس فقط لصدفة الأوامر التفاعلية لديك.
يحمّل OpenClaw الملف ~/.openclaw/.env عند تحميل الإعداد، ولذلك تصل المفاتيح المخزّنة فيه إلى خدمات Gateway المُدارة على كل منصة. أعد تشغيل Gateway (أو شغّل openclaw doctor --fix مجددًا) بعد تدوير المفتاح.
ذو صلة
اختيار المزوّدين ومراجع النماذج وسلوك تجاوز الفشل.
مستويات /think وسياسات المزوّدين وتوجيه النماذج القادرة على الاستدلال.
شغّل Kimi مع مخرجات التفكير الأصلية عبر واجهة API الخاصة بـ Moonshot.
استكشاف الأخطاء وإصلاحها عمومًا والأسئلة الشائعة.
