الانتقال إلى المحتوى الرئيسي
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

البدء

1

ثبّت Plugin

openclaw plugins install @openclaw/fireworks-provider
2

اضبط مفتاح 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 كنموذج افتراضي.
3

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

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-k2p6Kimi K2.6نص + صورة262,144262,144متوقف إجباريًا
fireworks/accounts/fireworks/routers/kimi-k2p5-turboKimi K2.5 Turbo (Fire Pass)نص + صورة256,000256,000متوقف إجباريًا (افتراضي)
يثبّت OpenClaw جميع نماذج Fireworks Kimi على thinking: off لأن Fireworks يرفض معاملات تفكير Kimi في الإنتاج. يتيح توجيه النموذج نفسه عبر Moonshot مباشرةً الحفاظ على مخرجات استدلال Kimi. راجع أوضاع التفكير للتبديل بين الموفّرين.

معرّفات نماذج 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.
يعيد Fireworks K2.6 رمز 400 إذا حمل الطلب معاملات reasoning_* رغم أن Kimi يدعم التفكير عبر API الخاصة بـ Moonshot. تعلن سياسة الموفّر (extensions/fireworks/thinking-policy.ts) مستوى التفكير off فقط لمعرّفات نماذج Kimi، لذلك تبقى مفاتيح /think اليدوية وأسطح سياسة الموفّر متوافقة مع عقد وقت التشغيل.لاستخدام استدلال Kimi من البداية إلى النهاية، كوّن موفّر Moonshot ووجّه النموذج نفسه عبره.
إذا كان Gateway يعمل كخدمة مُدارة (launchd أو systemd أو Docker)، فيجب أن يكون مفتاح Fireworks مرئيًا لتلك العملية، وليس فقط للصدفة التفاعلية لديك.
لن يساعد مفتاح مُصدَّر في صدفة تفاعلية فقط برنامجًا خفيًا يعمل عبر launchd أو systemd ما لم تُستورد تلك البيئة هناك أيضًا. اضبط المفتاح في ~/.openclaw/.env أو عبر env.shellEnv لجعله قابلاً للقراءة من عملية Gateway.
على macOS، يقوم openclaw gateway install بالفعل بتوصيل ~/.openclaw/.env بملف بيئة LaunchAgent. أعد تشغيل التثبيت (أو openclaw doctor --fix) بعد تدوير المفتاح.

ذات صلة

موفّرو النماذج

اختيار الموفّرين، ومراجع النماذج، وسلوك تجاوز الفشل.

أوضاع التفكير

مستويات /think، وسياسات الموفّر، وتوجيه النماذج القادرة على الاستدلال.

Moonshot

شغّل Kimi مع مخرجات التفكير الأصلية عبر API الخاصة بـ Moonshot.

استكشاف الأخطاء وإصلاحها

استكشاف الأخطاء وإصلاحها بشكل عام والأسئلة الشائعة.