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

    bash
    openclaw plugins install @openclaw/fireworks-provider
  • اضبط مفتاح Fireworks API

    الإعداد الأولي
    openclaw onboard --auth-choice fireworks-api-key
    العلم المباشر
    openclaw onboard --non-interactive \--auth-choice fireworks-api-key \--fireworks-api-key "$FIREWORKS_API_KEY"
    البيئة فقط
    export FIREWORKS_API_KEY=fw-...

    يخزّن الإعداد الأولي المفتاح مقابل موفّر fireworks في ملفات تعريف المصادقة لديك، ويعيّن موجّه Fire Pass Kimi K2.5 Turbo كنموذج افتراضي.

  • تحقّق من أن النموذج متاح

    bash
    openclaw models list --provider fireworks

    يجب أن تتضمن القائمة Kimi K2.6 وKimi K2.5 Turbo (Fire Pass). إذا لم يتم حل FIREWORKS_API_KEY، فسيُبلغ openclaw models status --json عن بيانات الاعتماد المفقودة ضمن auth.unusableProfiles.

  • إعداد غير تفاعلي

    للتثبيتات النصية أو تثبيتات CI، مرّر كل شيء عبر سطر الأوامر:

    bash
    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 الديناميكية كنص فقط ما لم تكوّن إدخال نموذج مخصصًا مع إدخال صور.

    json5
    {  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 K2.6 رمز 400 إذا حمل الطلب معاملات reasoning_* رغم أن Kimi يدعم التفكير عبر API الخاصة بـ Moonshot. تعلن سياسة الموفّر (extensions/fireworks/thinking-policy.ts) مستوى التفكير off فقط لمعرّفات نماذج Kimi، لذلك تبقى مفاتيح /think اليدوية وأسطح سياسة الموفّر متوافقة مع عقد وقت التشغيل.

    لاستخدام استدلال Kimi من البداية إلى النهاية، كوّن موفّر Moonshot ووجّه النموذج نفسه عبره.

    توفر البيئة للبرنامج الخفي

    إذا كان Gateway يعمل كخدمة مُدارة (launchd أو systemd أو Docker)، فيجب أن يكون مفتاح Fireworks مرئيًا لتلك العملية، وليس فقط للصدفة التفاعلية لديك.

    على macOS، يقوم openclaw gateway install بالفعل بتوصيل ~/.openclaw/.env بملف بيئة LaunchAgent. أعد تشغيل التثبيت (أو openclaw doctor --fix) بعد تدوير المفتاح.

    ذات صلة

    Was this useful?
    On this page

    On this page