Providers
Groq
Groq يوفر استدلالًا فائق السرعة على نماذج مفتوحة الأوزان (Llama وGemma وKimi وQwen وGPT OSS والمزيد) باستخدام عتاد LPU مخصص. يتضمن OpenClaw Plugin مدمجًا لـ Groq يسجل كلًا من مزود دردشة متوافق مع OpenAI ومزود فهم وسائط صوتية.
| الخاصية | القيمة |
|---|---|
| معرف المزود | groq |
| Plugin | مدمج، enabledByDefault: true |
| متغير بيئة المصادقة | GROQ_API_KEY |
| علم الإعداد الأولي | --auth-choice groq-api-key |
| API | متوافق مع OpenAI (openai-completions) |
| عنوان URL الأساسي | https://api.groq.com/openai/v1 |
| نسخ الصوت | whisper-large-v3-turbo (الافتراضي) |
| الإعداد الافتراضي المقترح للدردشة | groq/llama-3.3-70b-versatile |
البدء
احصل على مفتاح API
أنشئ مفتاح API في console.groq.com/keys.
عيّن مفتاح API
openclaw onboard --auth-choice groq-api-key
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-maverick-17b-128e-instruct |
Llama 4 Maverick 17B | لا | نص + صورة | 131,072 |
groq/meta-llama/llama-4-scout-17b-16e-instruct |
Llama 4 Scout 17B | لا | نص + صورة | 131,072 |
groq/llama3-70b-8192 |
Llama 3 70B | لا | نص | 8,192 |
groq/llama3-8b-8192 |
Llama 3 8B | لا | نص | 8,192 |
groq/gemma2-9b-it |
Gemma 2 9B | لا | نص | 8,192 |
groq/mistral-saba-24b |
Mistral Saba 24B | لا | نص | 32,768 |
groq/moonshotai/kimi-k2-instruct |
Kimi K2 Instruct | لا | نص | 131,072 |
groq/moonshotai/kimi-k2-instruct-0905 |
Kimi K2 Instruct 0905 | لا | نص | 262,144 |
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-qwq-32b |
Qwen QwQ 32B | نعم | نص | 131,072 |
groq/qwen/qwen3-32b |
Qwen3 32B | نعم | نص | 131,072 |
groq/deepseek-r1-distill-llama-70b |
DeepSeek R1 Distill Llama 70B | نعم | نص | 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-*)، يرسل OpenClawlowأوmediumأوhighبناءً على مستوى/think. عند تعطيل التفكير، لا يرسلreasoning_effortلأن هذه النماذج لا تدعم قيمة معطلة. - تستخدم DeepSeek R1 Distill وQwen QwQ وCompound سطح الاستدلال الأصلي في Groq؛ يتحكم
/thinkفي الظهور، لكن النموذج يستدل دائمًا.
راجع أوضاع التفكير لمعرفة مستويات /think المشتركة وكيف يترجمها OpenClaw لكل مزود.
نسخ الصوت
يسجل Plugin Groq المدمج أيضًا مزود فهم وسائط صوتية بحيث يمكن نسخ الرسائل الصوتية عبر سطح 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>" },
},
},
}