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
یک کلید 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 |
مدلهای استدلالی
مدلهای استدلالی 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 به زیرسامانه صوتی پیشفرض:
{ 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>" }, }, },}