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 را راهاندازی مجدد کنید:
openclaw plugins install @openclaw/groq-provideropenclaw gateway restartشروع به کار
دریافت کلید API
در console.groq.com/keys یک کلید API ایجاد کنید.
تنظیم کلید API
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 مبتنی بر مانیفست ارائه میکند که شامل ورودیهای استدلالی و غیراستدلالی است. برای مشاهدهٔ ردیفهای ثابت نسخهٔ نصبشدهٔ خود، 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 بهعنوان پشتیبان صوتی پیشفرض:
{ tools: { media: { audio: { models: [{ provider: "groq" }], }, }, },}دسترسپذیری محیط برای سرویس پسزمینه
اگر Gateway بهصورت یک سرویس مدیریتشده (launchd، systemd یا Docker) اجرا میشود، GROQ_API_KEY باید برای همان فرایند قابل مشاهده باشد، نه فقط برای پوستهٔ تعاملی شما.
شناسههای سفارشی مدل Groq
OpenClaw در زمان اجرا هر شناسهٔ مدل Groq را میپذیرد. از شناسهٔ دقیق نمایشدادهشده توسط Groq استفاده کنید و پیشوند groq/ را به آن بیفزایید. فهرست ثابت موارد متداول را پوشش میدهد؛ شناسههای فهرستنشده از الگوی پیشفرض سازگار با OpenAI استفاده میکنند.
{ agents: { defaults: { model: { primary: "groq/<your-model-id>" }, }, },}