OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

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:

bash
openclaw plugins install @openclaw/groq-provideropenclaw gateway restart

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

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

    أنشئ مفتاح API على console.groq.com/keys.

  • تعيين مفتاح API

    bash
    export GROQ_API_KEY=gsk_...

  • تعيين نموذج افتراضي

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

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

    bash
    openclaw models list --provider groq

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

    json5
    {  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

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

    تربط نماذج الاستدلال في 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 الواجهة الخلفية الافتراضية للصوت:

    json5
    {  tools: {    media: {      audio: {        models: [{ provider: "groq" }],      },    },  },}
    توفر البيئة للخدمة الخفية

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

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

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

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

    ذو صلة

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

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

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

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

    لوحة معلومات Groq ووثائق API والأسعار.
    Was this useful?
    On this page

    On this page