> ## 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](https://fireworks.ai) يتيح نماذج ذات أوزان مفتوحة ونماذج موجّهة عبر 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`                                      |

## البدء

<Steps>
  <Step title="ثبّت Plugin">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw plugins install @openclaw/fireworks-provider
    ```
  </Step>

  <Step title="اضبط مفتاح Fireworks API">
    <CodeGroup>
      ```bash الإعداد الأولي theme={"theme":{"light":"min-light","dark":"min-dark"}}
      openclaw onboard --auth-choice fireworks-api-key
      ```

      ```bash العلم المباشر theme={"theme":{"light":"min-light","dark":"min-dark"}}
      openclaw onboard --non-interactive \
        --auth-choice fireworks-api-key \
        --fireworks-api-key "$FIREWORKS_API_KEY"
      ```

      ```bash البيئة فقط theme={"theme":{"light":"min-light","dark":"min-dark"}}
      export FIREWORKS_API_KEY=fw-...
      ```
    </CodeGroup>

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

  <Step title="تحقّق من أن النموذج متاح">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw models list --provider fireworks
    ```

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

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

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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             | متوقف إجباريًا (افتراضي) |

<Note>
  يثبّت OpenClaw جميع نماذج Fireworks Kimi على `thinking: off` لأن Fireworks يرفض معاملات تفكير Kimi في الإنتاج. يتيح توجيه النموذج نفسه عبر [Moonshot](/ar/providers/moonshot) مباشرةً الحفاظ على مخرجات استدلال Kimi. راجع [أوضاع التفكير](/ar/tools/thinking) للتبديل بين الموفّرين.
</Note>

## معرّفات نماذج Fireworks المخصصة

يقبل OpenClaw أي نموذج Fireworks أو معرّف موجّه أثناء وقت التشغيل. استخدم المعرّف الدقيق الذي تعرضه Fireworks وأضف إليه البادئة `fireworks/`. ينسخ الحل الديناميكي قالب Fire Pass (إدخال نص + صورة، وAPI متوافقة مع OpenAI، وتكلفة افتراضية صفر)، ويعطّل التفكير تلقائيًا عندما يطابق المعرّف نمط Kimi. تُعلَّم معرّفات GLM الديناميكية كنص فقط ما لم تكوّن إدخال نموذج مخصصًا مع إدخال صور.

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  agents: {
    defaults: {
      model: {
        primary: "fireworks/accounts/fireworks/models/<your-model-id>",
      },
    },
  },
}
```

<AccordionGroup>
  <Accordion title="كيف تعمل بادئة معرّف النموذج">
    يبدأ كل مرجع نموذج Fireworks في OpenClaw بـ `fireworks/` متبوعًا بالمعرّف الدقيق أو مسار الموجّه من منصة Fireworks. على سبيل المثال:

    * نموذج موجّه: `fireworks/accounts/fireworks/routers/kimi-k2p5-turbo`
    * نموذج مباشر: `fireworks/accounts/fireworks/models/<model-name>`

    يزيل OpenClaw البادئة `fireworks/` عند إنشاء طلب API ويرسل المسار المتبقي إلى نقطة نهاية Fireworks كحقل `model` المتوافق مع OpenAI.
  </Accordion>

  <Accordion title="لماذا يُفرض إيقاف التفكير لـ Kimi">
    يعيد Fireworks K2.6 رمز 400 إذا حمل الطلب معاملات `reasoning_*` رغم أن Kimi يدعم التفكير عبر API الخاصة بـ Moonshot. تعلن سياسة الموفّر (`extensions/fireworks/thinking-policy.ts`) مستوى التفكير `off` فقط لمعرّفات نماذج Kimi، لذلك تبقى مفاتيح `/think` اليدوية وأسطح سياسة الموفّر متوافقة مع عقد وقت التشغيل.

    لاستخدام استدلال Kimi من البداية إلى النهاية، كوّن [موفّر Moonshot](/ar/providers/moonshot) ووجّه النموذج نفسه عبره.
  </Accordion>

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

    <Warning>
      لن يساعد مفتاح مُصدَّر في صدفة تفاعلية فقط برنامجًا خفيًا يعمل عبر launchd أو systemd ما لم تُستورد تلك البيئة هناك أيضًا. اضبط المفتاح في `~/.openclaw/.env` أو عبر `env.shellEnv` لجعله قابلاً للقراءة من عملية Gateway.
    </Warning>

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

## ذات صلة

<CardGroup cols={2}>
  <Card title="موفّرو النماذج" href="/ar/concepts/model-providers" icon="layers">
    اختيار الموفّرين، ومراجع النماذج، وسلوك تجاوز الفشل.
  </Card>

  <Card title="أوضاع التفكير" href="/ar/tools/thinking" icon="brain">
    مستويات `/think`، وسياسات الموفّر، وتوجيه النماذج القادرة على الاستدلال.
  </Card>

  <Card title="Moonshot" href="/ar/providers/moonshot" icon="moon">
    شغّل Kimi مع مخرجات التفكير الأصلية عبر API الخاصة بـ Moonshot.
  </Card>

  <Card title="استكشاف الأخطاء وإصلاحها" href="/ar/help/troubleshooting" icon="wrench">
    استكشاف الأخطاء وإصلاحها بشكل عام والأسئلة الشائعة.
  </Card>
</CardGroup>