Groq

Groq توفّر استدلالًا فائق السرعة على النماذج ذات الأوزان المفتوحة (Llama وGemma وKimi وQwen وGPT OSS وغيرها) باستخدام عتاد LPU مخصص. يسجّل Plugin ‏Groq موفّر محادثة متوافقًا مع 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

بدء الاستخدام

الحصول على مفتاح 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 مدعوم ببيان، ويضم إدخالات استدلالية وغير استدلالية. شغّل 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. يعرض openclaw models list --provider groq الصفوف المعروفة للإصدار المثبّت لديك؛ وقارنها مع console.groq.com/docs/models لمعرفة النماذج المضافة حديثًا أو المهملة.

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

تربط نماذج الاستدلال في Groq (ذات reasoning: true في الجدول أعلاه) مستويات /think المشتركة في OpenClaw بقيم reasoning_effort التي تساوي low أو medium أو high. يؤدي /think off أو /think none إلى حذف reasoning_effort من الطلب بدلًا من إرسال قيمة تعطيل. راجع أوضاع التفكير لمعرفة مستويات /think المشتركة وكيفية ترجمة OpenClaw لها حسب كل موفّر.

نسخ الصوت

يسجّل Plugin ‏Groq أيضًا موفّرًا لفهم الوسائط الصوتية بحيث يمكن نسخ الرسائل الصوتية عبر الواجهة المشتركة tools.media.audio.

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

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

{
  tools: {
    media: {
      audio: {
        models: [{ provider: "groq" }],
      },
    },
  },
}

توفر البيئة للخدمة الخفية

إذا كان Gateway يعمل كخدمة مُدارة (launchd أو systemd أو Docker)، فيجب أن يكون GROQ_API_KEY مرئيًا لتلك العملية، وليس فقط لصدفتك التفاعلية.

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

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

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

{
  agents: {
    defaults: {
      model: { primary: "groq/<your-model-id>" },
    },
  },
}

ذو صلة

موفّرو النماذج

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

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

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

مرجع الإعداد

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

وحدة تحكم Groq

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

Overview

Concepts and configuration

Providers

تثبيت Plugin

بدء الاستخدام

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

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

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

نسخ الصوت

ذو صلة

موفّرو النماذج

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

مرجع الإعداد

وحدة تحكم Groq

​تثبيت Plugin

​بدء الاستخدام

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

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

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

​نسخ الصوت

​ذو صلة

موفّرو النماذج

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

مرجع الإعداد

وحدة تحكم Groq

تثبيت Plugin

بدء الاستخدام

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

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

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

نسخ الصوت

ذو صلة