Providers

Groq

Groq با استفاده از سخت‌افزار سفارشی LPU، استنتاجی فوق‌سریع را روی مدل‌های دارای وزن‌های باز (Llama، Gemma، Kimi، Qwen، GPT OSS و مدل‌های دیگر) ارائه می‌دهد. Plugin مربوط به Groq هم یک ارائه‌دهندهٔ گفت‌وگوی سازگار با OpenAI و هم یک ارائه‌دهندهٔ درک رسانه‌ای صوتی را ثبت می‌کند.

ویژگی مقدار
شناسهٔ ارائه‌دهنده groq
Plugin بستهٔ خارجی رسمی
متغیر محیطی احراز هویت GROQ_API_KEY
API سازگار با OpenAI (openai-completions)
نشانی پایه 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

    در console.groq.com/keys یک کلید API ایجاد کنید.

  • تنظیم کلید 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 را اجرا کنید، یا برای مشاهدهٔ فهرست مرجع Groq به console.groq.com/docs/models مراجعه کنید.

    ارجاع مدل نام استدلالی ورودی زمینه
    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 را به مقادیر low، medium یا high برای reasoning_effort نگاشت می‌کنند. گزینهٔ /think off یا /think none به‌جای ارسال یک مقدار غیرفعال، reasoning_effort را از درخواست حذف می‌کند.

    برای آشنایی با سطوح مشترک /think و نحوهٔ ترجمهٔ آن‌ها توسط OpenClaw برای هر ارائه‌دهنده، به حالت‌های تفکر مراجعه کنید.

    رونویسی صوتی

    Plugin مربوط به Groq همچنین یک ارائه‌دهندهٔ درک رسانه‌ای صوتی را ثبت می‌کند تا پیام‌های صوتی از طریق سطح مشترک tools.media.audio رونویسی شوند.

    ویژگی مقدار
    مسیر پیکربندی مشترک tools.media.audio
    نشانی پایهٔ پیش‌فرض 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>" },    },  },}

    مطالب مرتبط

    Was this useful?
    On this page

    On this page