> ## 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.

# Groq

يوفّر [Groq](https://groq.com) استدلالًا فائق السرعة على نماذج مفتوحة الأوزان (Llama وGemma وKimi وQwen وGPT OSS وغير ذلك) باستخدام عتاد LPU مخصّص. يسجّل Groq Plugin كلًا من مزوّد محادثة متوافق مع OpenAI ومزوّد لفهم الوسائط الصوتية.

| الخاصية                  | القيمة                                  |
| ------------------------ | --------------------------------------- |
| معرّف المزوّد            | `groq`                                  |
| Plugin                   | حزمة خارجية رسمية                       |
| متغيّر بيئة المصادقة     | `GROQ_API_KEY`                          |
| API                      | متوافق مع OpenAI (`openai-completions`) |
| عنوان URL الأساسي        | `https://api.groq.com/openai/v1`        |
| تفريغ الصوت              | `whisper-large-v3-turbo` (افتراضي)      |
| افتراضي المحادثة المقترح | `groq/llama-3.3-70b-versatile`          |

## تثبيت Plugin

ثبّت Plugin الرسمي، ثم أعد تشغيل Gateway:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins install @openclaw/groq-provider
openclaw gateway restart
```

## البدء

<Steps>
  <Step title="احصل على مفتاح API">
    أنشئ مفتاح API في [console.groq.com/keys](https://console.groq.com/keys).
  </Step>

  <Step title="اضبط مفتاح API">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    export GROQ_API_KEY=gsk_...
    ```
  </Step>

  <Step title="اضبط نموذجًا افتراضيًا">
    ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
    {
      agents: {
        defaults: {
          model: { primary: "groq/llama-3.3-70b-versatile" },
        },
      },
    }
    ```
  </Step>

  <Step title="تحقّق من إمكانية الوصول إلى الكتالوج">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw models list --provider groq
    ```
  </Step>
</Steps>

### مثال ملف الإعداد

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  env: { GROQ_API_KEY: "gsk_..." },
  agents: {
    defaults: {
      model: { primary: "groq/llama-3.3-70b-versatile" },
    },
  },
}
```

## الكتالوج المضمّن

يشحن OpenClaw كتالوج Groq مستندًا إلى manifest، مع إدخالات للاستدلال وبدونه. شغّل `openclaw models list --provider groq` للاطلاع على الصفوف الثابتة في نسختك المثبّتة، أو راجع [console.groq.com/docs/models](https://console.groq.com/docs/models) للحصول على قائمة Groq الموثوقة.

| مرجع النموذج                                     | الاسم                   | الاستدلال | الإدخال   | السياق  |
| ------------------------------------------------ | ----------------------- | --------- | --------- | ------- |
| `groq/llama-3.3-70b-versatile`                   | Llama 3.3 70B Versatile | لا        | نص        | 131,072 |
| `groq/llama-3.1-8b-instant`                      | Llama 3.1 8B Instant    | لا        | نص        | 131,072 |
| `groq/meta-llama/llama-4-scout-17b-16e-instruct` | Llama 4 Scout 17B       | لا        | نص + صورة | 131,072 |
| `groq/openai/gpt-oss-120b`                       | GPT OSS 120B            | نعم       | نص        | 131,072 |
| `groq/openai/gpt-oss-20b`                        | GPT OSS 20B             | نعم       | نص        | 131,072 |
| `groq/openai/gpt-oss-safeguard-20b`              | Safety GPT OSS 20B      | نعم       | نص        | 131,072 |
| `groq/qwen/qwen3-32b`                            | Qwen3 32B               | نعم       | نص        | 131,072 |
| `groq/groq/compound`                             | Compound                | نعم       | نص        | 131,072 |
| `groq/groq/compound-mini`                        | Compound Mini           | نعم       | نص        | 131,072 |

<Tip>
  يتطوّر الكتالوج مع كل إصدار من OpenClaw. يعرض `openclaw models list --provider groq` الصفوف المعروفة لنسختك المثبّتة؛ قارِنها مع [console.groq.com/docs/models](https://console.groq.com/docs/models) للتحقّق من النماذج المضافة حديثًا أو المهملة.
</Tip>

## نماذج الاستدلال

يربط OpenClaw مستويات `/think` المشتركة بقيم `reasoning_effort` الخاصة بنماذج Groq:

* بالنسبة إلى `qwen/qwen3-32b`، يرسل تعطيل التفكير `none` ويرسل تفعيل التفكير `default`.
* بالنسبة إلى نماذج الاستدلال Groq GPT OSS (`openai/gpt-oss-*`)، يرسل OpenClaw القيمة `low` أو `medium` أو `high` بناءً على مستوى `/think`. عند تعطيل التفكير، لا يرسل `reasoning_effort` لأن هذه النماذج لا تدعم قيمة معطّلة.
* تستخدم DeepSeek R1 Distill وQwen QwQ وCompound واجهة الاستدلال الأصلية في Groq؛ يتحكّم `/think` في الظهور، لكن النموذج يستدل دائمًا.

راجع [أوضاع التفكير](/ar/tools/thinking) لمعرفة مستويات `/think` المشتركة وكيف يترجمها OpenClaw لكل مزوّد.

## تفريغ الصوت

يسجّل Groq Plugin أيضًا **مزوّدًا لفهم الوسائط الصوتية** حتى يمكن تفريغ الرسائل الصوتية عبر واجهة `tools.media.audio` المشتركة.

| الخاصية                     | القيمة                                    |
| --------------------------- | ----------------------------------------- |
| مسار الإعداد المشترك        | `tools.media.audio`                       |
| عنوان URL الافتراضي الأساسي | `https://api.groq.com/openai/v1`          |
| النموذج الافتراضي           | `whisper-large-v3-turbo`                  |
| الأولوية التلقائية          | 20                                        |
| نقطة نهاية API              | متوافقة مع OpenAI `/audio/transcriptions` |

لجعل Groq الواجهة الخلفية الافتراضية للصوت:

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  tools: {
    media: {
      audio: {
        models: [{ provider: "groq" }],
      },
    },
  },
}
```

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

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

  <Accordion title="معرّفات نماذج Groq المخصّصة">
    يقبل OpenClaw أي معرّف نموذج Groq وقت التشغيل. استخدم المعرّف الدقيق الذي يعرضه Groq وأضف إليه البادئة `groq/`. يغطي الكتالوج الثابت الحالات الشائعة؛ أما المعرّفات غير المدرجة في الكتالوج فتمرّ إلى القالب الافتراضي المتوافق مع OpenAI.

    ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
    {
      agents: {
        defaults: {
          model: { primary: "groq/<your-model-id>" },
        },
      },
    }
    ```
  </Accordion>
</AccordionGroup>

## ذات صلة

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

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

  <Card title="مرجع الإعداد" href="/ar/gateway/configuration-reference" icon="gear">
    مخطط الإعداد الكامل، بما في ذلك إعدادات المزوّد والصوت.
  </Card>

  <Card title="Groq Console" href="https://console.groq.com" icon="arrow-up-right-from-square">
    لوحة تحكم Groq ووثائق API والتسعير.
  </Card>
</CardGroup>