Providers
Groq
يوفّر 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-provideropenclaw gateway restartالبدء
احصل على مفتاح API
أنشئ مفتاح API في console.groq.com/keys.
اضبط مفتاح API
export GROQ_API_KEY=gsk_...اضبط نموذجًا افتراضيًا
{ agents: { defaults: { model: { primary: "groq/llama-3.3-70b-versatile" }, }, },}تحقّق من إمكانية الوصول إلى الكتالوج
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-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 |
نماذج الاستدلال
يربط 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 مرئيًا لتلك العملية، وليس فقط للصدفة التفاعلية لديك.
معرّفات نماذج Groq المخصّصة
يقبل OpenClaw أي معرّف نموذج Groq وقت التشغيل. استخدم المعرّف الدقيق الذي يعرضه Groq وأضف إليه البادئة groq/. يغطي الكتالوج الثابت الحالات الشائعة؛ أما المعرّفات غير المدرجة في الكتالوج فتمرّ إلى القالب الافتراضي المتوافق مع OpenAI.
{ agents: { defaults: { model: { primary: "groq/<your-model-id>" }, }, },}