الانتقال إلى المحتوى الرئيسي

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Fireworks تتيح نماذج مفتوحة الأوزان ونماذج موجّهة عبر API متوافق مع OpenAI. يتضمن OpenClaw Plugin مزود Fireworks مضمّنا يأتي مع نموذجي Kimi مفهرسين مسبقا ويقبل أي معرّف نموذج أو موجّه من Fireworks في وقت التشغيل.
الخاصيةالقيمة
معرّف المزودfireworks (الاسم البديل: fireworks-ai)
Pluginمضمّن، enabledByDefault: true
متغير بيئة المصادقة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

Set the Fireworks API key

openclaw onboard --auth-choice fireworks-api-key
يخزن الإعداد الأولي المفتاح مقابل مزود fireworks في ملفات تعريف المصادقة لديك ويعيّن موجّه Kimi K2.5 Turbo Fire Pass كنموذج افتراضي.
2

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-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. 
{
  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 مرئيا لتلك العملية، وليس فقط لصدفتك التفاعلية.
لن يفيد المفتاح الموجود فقط في ~/.profile عفريت launchd أو systemd ما لم يتم استيراد تلك البيئة هناك أيضا. اضبط المفتاح في ~/.openclaw/.env أو عبر env.shellEnv لجعله قابلا للقراءة من عملية Gateway.
على macOS، يقوم openclaw gateway install بالفعل بتوصيل ~/.openclaw/.env بملف بيئة LaunchAgent. أعد تشغيل التثبيت (أو openclaw doctor --fix) بعد تدوير المفتاح.

​
ذو صلة

Model providers

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

Thinking modes

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

Moonshot

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

Troubleshooting

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