Providers
Groq
Groq надає надшвидкий inference для моделей з відкритими вагами (Llama, Gemma, Kimi, Qwen, GPT OSS тощо) за допомогою спеціального обладнання LPU. OpenClaw містить вбудований Groq plugin, який реєструє і OpenAI-сумісний провайдер чату, і провайдер розуміння аудіомедіа.
| Властивість | Значення |
|---|---|
| ID провайдера | groq |
| Plugin | вбудований, enabledByDefault: true |
| Змінна env для auth | GROQ_API_KEY |
| Прапорець onboarding | --auth-choice groq-api-key |
| API | OpenAI-сумісний (openai-completions) |
| Базова URL-адреса | 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-каталогом на основі маніфесту, що містить записи як із reasoning, так і без нього. Виконайте openclaw models list --provider groq, щоб переглянути вбудовані рядки для встановленої версії, або перевірте console.groq.com/docs/models, щоб побачити авторитетний список Groq.
| Посилання на модель | Назва | Reasoning | Вхід | Контекст |
|---|---|---|---|---|
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 |
Моделі reasoning
OpenClaw зіставляє свої спільні рівні /think із специфічними для моделей Groq значеннями reasoning_effort:
- Для
qwen/qwen3-32bвимкнене thinking надсилаєnone, а ввімкнене thinking надсилаєdefault. - Для моделей Groq GPT OSS reasoning (
openai/gpt-oss-*) OpenClaw надсилаєlow,mediumабоhighзалежно від рівня/think. Вимкнене thinking пропускаєreasoning_effort, оскільки ці моделі не підтримують значення для вимкнення. - DeepSeek R1 Distill, Qwen QwQ і Compound використовують нативну reasoning-поверхню Groq;
/thinkкерує видимістю, але модель завжди міркує.
Див. Режими thinking, щоб дізнатися про спільні рівні /think і те, як OpenClaw перекладає їх для кожного провайдера.
Транскрипція аудіо
Вбудований plugin Groq також реєструє провайдер розуміння аудіомедіа, щоб голосові повідомлення можна було транскрибувати через спільну поверхню tools.media.audio.
| Властивість | Значення |
|---|---|
| Спільний шлях конфігурації | tools.media.audio |
| Типова базова URL-адреса | https://api.groq.com/openai/v1 |
| Типова модель | whisper-large-v3-turbo |
| Автоматичний пріоритет | 20 |
| API endpoint | OpenAI-сумісний /audio/transcriptions |
Щоб зробити Groq типовим backend для аудіо:
{
tools: {
media: {
audio: {
models: [{ provider: "groq" }],
},
},
},
}
Доступність середовища для daemon
Якщо Gateway працює як керований сервіс (launchd, systemd, Docker), GROQ_API_KEY має бути видимим для цього процесу — не лише для вашої інтерактивної shell.
Власні ID моделей Groq
OpenClaw приймає будь-який ID моделі Groq під час виконання. Використовуйте точний ID, який показує Groq, і додайте до нього префікс groq/. Вбудований каталог покриває поширені випадки; некаталогізовані ID переходять до типового OpenAI-сумісного шаблону.
{
agents: {
defaults: {
model: { primary: "groq/<your-model-id>" },
},
},
}