الانتقال إلى المحتوى الرئيسي
يوفّر Groq استدلالًا فائق السرعة على نماذج مفتوحة الأوزان (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: 
openclaw plugins install @openclaw/groq-provider
openclaw gateway restart

​
البدء

1

احصل على مفتاح API

أنشئ مفتاح API في console.groq.com/keys.
2

اضبط مفتاح API

export GROQ_API_KEY=gsk_...
3

اضبط نموذجًا افتراضيًا

{
  agents: {
    defaults: {
      model: { primary: "groq/llama-3.3-70b-versatile" },
    },
  },
}
4

تحقّق من إمكانية الوصول إلى الكتالوج

openclaw models list --provider groq

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

{
  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 للحصول على قائمة Groq الموثوقة.
مرجع النموذجالاسمالاستدلالالإدخالالسياق
groq/llama-3.3-70b-versatileLlama 3.3 70B Versatileلانص131,072
groq/llama-3.1-8b-instantLlama 3.1 8B Instantلانص131,072
groq/meta-llama/llama-4-scout-17b-16e-instructLlama 4 Scout 17Bلانص + صورة131,072
groq/openai/gpt-oss-120bGPT OSS 120Bنعمنص131,072
groq/openai/gpt-oss-20bGPT OSS 20Bنعمنص131,072
groq/openai/gpt-oss-safeguard-20bSafety GPT OSS 20Bنعمنص131,072
groq/qwen/qwen3-32bQwen3 32Bنعمنص131,072
groq/groq/compoundCompoundنعمنص131,072
groq/groq/compound-miniCompound Miniنعمنص131,072
يتطوّر الكتالوج مع كل إصدار من OpenClaw. يعرض openclaw models list --provider groq الصفوف المعروفة لنسختك المثبّتة؛ قارِنها مع console.groq.com/docs/models للتحقّق من النماذج المضافة حديثًا أو المهملة.

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

يربط 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 في الظهور، لكن النموذج يستدل دائمًا.
راجع أوضاع التفكير لمعرفة مستويات /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 الواجهة الخلفية الافتراضية للصوت: 
{
  tools: {
    media: {
      audio: {
        models: [{ provider: "groq" }],
      },
    },
  },
}
إذا كان Gateway يعمل كخدمة مُدارة (launchd أو systemd أو Docker)، فيجب أن يكون GROQ_API_KEY مرئيًا لتلك العملية، وليس فقط للصدفة التفاعلية لديك.
لن يفيد المفتاح المصدّر في صدفة تفاعلية فقط برنامجًا خفيًا من launchd أو systemd ما لم تُستورد تلك البيئة هناك أيضًا. اضبط المفتاح في ~/.openclaw/.env أو عبر env.shellEnv لجعله قابلًا للقراءة من عملية gateway.
يقبل OpenClaw أي معرّف نموذج Groq وقت التشغيل. استخدم المعرّف الدقيق الذي يعرضه Groq وأضف إليه البادئة groq/. يغطي الكتالوج الثابت الحالات الشائعة؛ أما المعرّفات غير المدرجة في الكتالوج فتمرّ إلى القالب الافتراضي المتوافق مع OpenAI.
{
  agents: {
    defaults: {
      model: { primary: "groq/<your-model-id>" },
    },
  },
}

​
ذات صلة

مزوّدو النماذج

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

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

مستويات جهد الاستدلال وتفاعل سياسة المزوّد.

مرجع الإعداد

مخطط الإعداد الكامل، بما في ذلك إعدادات المزوّد والصوت.

Groq Console

لوحة تحكم Groq ووثائق API والتسعير.