الانتقال إلى المحتوى الرئيسي

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

​
البدء

1

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

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

عيّن مفتاح API

openclaw onboard --auth-choice groq-api-key
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-maverick-17b-128e-instructLlama 4 Maverick 17Bلانص + صورة131,072
groq/meta-llama/llama-4-scout-17b-16e-instructLlama 4 Scout 17Bلانص + صورة131,072
groq/llama3-70b-8192Llama 3 70Bلانص8,192
groq/llama3-8b-8192Llama 3 8Bلانص8,192
groq/gemma2-9b-itGemma 2 9Bلانص8,192
groq/mistral-saba-24bMistral Saba 24Bلانص32,768
groq/moonshotai/kimi-k2-instructKimi K2 Instructلانص131,072
groq/moonshotai/kimi-k2-instruct-0905Kimi K2 Instruct 0905لانص262,144
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-qwq-32bQwen QwQ 32Bنعمنص131,072
groq/qwen/qwen3-32bQwen3 32Bنعمنص131,072
groq/deepseek-r1-distill-llama-70bDeepSeek R1 Distill Llama 70Bنعمنص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 لكل مزود.

​
نسخ الصوت

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

​
ذات صلة

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

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

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

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

مرجع الإعدادات

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

Groq Console

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