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 را دوباره راهاندازی کنید:
openclaw plugins install @openclaw/groq-provideropenclaw gateway restartشروع به کار
دریافت کلید API
یک کلید API در console.groq.com/keys ایجاد کنید.
تنظیم کلید 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 |
مدلهای استدلالی
OpenClaw سطحهای مشترک /think خود را به مقدارهای اختصاصی مدل reasoning_effort در Groq نگاشت میکند:
- برای
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 |
| URL پایه پیشفرض | https://api.groq.com/openai/v1 |
| مدل پیشفرض | whisper-large-v3-turbo |
| اولویت خودکار | 20 |
| نقطه پایانی API | سازگار با OpenAI /audio/transcriptions |
برای تبدیل 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>" }, }, },}