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`)
نشانی پایه	`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 را اجرا کنید، یا برای فهرست مرجع 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-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 خود را به مقدارهای اختصاصی مدل Groq در reasoning_effort نگاشت می‌کند:

برای qwen/qwen3-32b، فکر کردن غیرفعال مقدار none و فکر کردن فعال مقدار default را ارسال می‌کند.
برای مدل‌های استدلالی Groq GPT OSS (openai/gpt-oss-*)، OpenClaw بر اساس سطح /think مقدار low، medium یا high را ارسال می‌کند. فکر کردن غیرفعال reasoning_effort را حذف می‌کند، چون این مدل‌ها از مقدار غیرفعال پشتیبانی نمی‌کنند.
DeepSeek R1 Distill، Qwen QwQ و Compound از سطح استدلالی بومی Groq استفاده می‌کنند؛ /think نمایانی را کنترل می‌کند، اما مدل همیشه استدلال می‌کند.

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

رونویسی صوتی

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

ویژگی	مقدار
مسیر پیکربندی مشترک	`tools.media.audio`
نشانی پایه پیش‌فرض	`https://api.groq.com/openai/v1`
مدل پیش‌فرض	`whisper-large-v3-turbo`
اولویت خودکار	20
نقطه پایانی API	سازگار با OpenAI `/audio/transcriptions`

برای قرار دادن Groq به‌عنوان بک‌اند صوتی پیش‌فرض:

{
  tools: {
    media: {
      audio: {
        models: [{ provider: "groq" }],
      },
    },
  },
}

دسترسی‌پذیری محیط برای daemon

اگر Gateway به‌عنوان یک سرویس مدیریت‌شده (launchd، systemd، Docker) اجرا شود، GROQ_API_KEY باید برای آن فرایند قابل مشاهده باشد، نه فقط برای پوسته تعاملی شما.

شناسه‌های سفارشی مدل Groq

OpenClaw هر شناسه مدل Groq را در زمان اجرا می‌پذیرد. از شناسه دقیق نمایش‌داده‌شده توسط Groq استفاده کنید و پیشوند groq/ را به آن اضافه کنید. کاتالوگ بسته‌بندی‌شده موارد رایج را پوشش می‌دهد؛ شناسه‌های خارج از کاتالوگ به الگوی پیش‌فرض سازگار با OpenAI منتقل می‌شوند.

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

مرتبط

ارائه‌دهندگان مدل

انتخاب ارائه‌دهندگان، ارجاع‌های مدل و رفتار failover.

حالت‌های فکر کردن

سطح‌های تلاش استدلالی و تعامل سیاست ارائه‌دهنده.

مرجع پیکربندی

طرح‌واره کامل پیکربندی شامل تنظیمات ارائه‌دهنده و صدا.

Groq Console

داشبورد Groq، مستندات API و قیمت‌گذاری.

# شروع به کار

دریافت کلید API

تنظیم کلید API

تنظیم مدل پیش‌فرض

تأیید دسترسی‌پذیری کاتالوگ

# نمونه فایل پیکربندی

# کاتالوگ داخلی

# مدل‌های استدلالی

# رونویسی صوتی