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

    یک کلید 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 را اجرا کنید؛ یا برای فهرست مرجع 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 را به مقادیر reasoning_effort شامل low، medium یا high نگاشت می‌کنند. /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