Перейти до основного вмісту
Groq забезпечує надшвидке інференс-виконання моделей з відкритими вагами (Llama, Gemma, Kimi, Qwen, GPT OSS тощо) за допомогою спеціального апаратного забезпечення LPU. Plugin Groq реєструє як OpenAI-сумісного провайдера чату, так і провайдера розуміння аудіомедіа.
ВластивістьЗначення
Ідентифікатор провайдераgroq
Pluginофіційний зовнішній пакет
Змінна середовища авторизаціїGROQ_API_KEY
APIOpenAI-сумісний (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-provider
openclaw gateway restart

​
Початок роботи

1

Отримайте API-ключ

Створіть API-ключ на console.groq.com/keys.
2

Задайте API-ключ

export GROQ_API_KEY=gsk_...
3

Задайте модель за замовчуванням

{
  agents: {
    defaults: {
      model: { primary: "groq/llama-3.3-70b-versatile" },
    },
  },
}
4

Перевірте доступність каталогу

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-versatileLlama 3.3 70B Versatileнітекст131,072
groq/llama-3.1-8b-instantLlama 3.1 8B Instantнітекст131,072
groq/meta-llama/llama-4-scout-17b-16e-instructLlama 4 Scout 17Bнітекст + зображення131,072
groq/openai/gpt-oss-120bGPT OSS 120Bтактекст131,072
groq/openai/gpt-oss-20bGPT OSS 20Bтактекст131,072
groq/openai/gpt-oss-safeguard-20bSafety GPT OSS 20Bтактекст131,072
groq/qwen/qwen3-32bQwen3 32Bтактекст131,072
groq/groq/compoundCompoundтактекст131,072
groq/groq/compound-miniCompound Miniтактекст131,072
Каталог змінюється з кожним випуском OpenClaw. openclaw models list --provider groq показує рядки, відомі вашій встановленій версії; звіряйтеся з console.groq.com/docs/models щодо новододаних або застарілих моделей.

​
Моделі reasoning

OpenClaw зіставляє свої спільні рівні /think зі специфічними для моделей Groq значеннями reasoning_effort:
  • Для qwen/qwen3-32b вимкнене мислення надсилає none, а ввімкнене мислення надсилає default.
  • Для моделей reasoning Groq GPT OSS (openai/gpt-oss-*) OpenClaw надсилає low, medium або high залежно від рівня /think. Якщо мислення вимкнено, reasoning_effort не надсилається, бо ці моделі не підтримують вимкнене значення.
  • DeepSeek R1 Distill, Qwen QwQ і Compound використовують нативну поверхню reasoning Groq; /think керує видимістю, але модель завжди виконує reasoning.
Див. Режими мислення для спільних рівнів /think і того, як OpenClaw транслює їх для кожного провайдера.

​
Транскрипція аудіо

Plugin Groq також реєструє провайдера розуміння аудіомедіа, щоб голосові повідомлення можна було транскрибувати через спільну поверхню tools.media.audio.
ВластивістьЗначення
Спільний шлях конфігураціїtools.media.audio
Базова URL-адреса за замовчуваннямhttps://api.groq.com/openai/v1
Модель за замовчуваннямwhisper-large-v3-turbo
Автоматичний пріоритет20
Кінцева точка APIOpenAI-сумісна /audio/transcriptions
Щоб зробити Groq аудіобекендом за замовчуванням: 
{
  tools: {
    media: {
      audio: {
        models: [{ provider: "groq" }],
      },
    },
  },
}
Якщо Gateway працює як керована служба (launchd, systemd, Docker), GROQ_API_KEY має бути видимим для цього процесу, а не лише для вашої інтерактивної оболонки.
Ключ, експортований лише в інтерактивній оболонці, не допоможе демону launchd або systemd, якщо це середовище також не імпортовано туди. Задайте ключ у ~/.openclaw/.env або через env.shellEnv, щоб gateway-процес міг його прочитати.
OpenClaw приймає будь-який ідентифікатор моделі Groq під час виконання. Використовуйте точний ідентифікатор, показаний Groq, і додайте до нього префікс groq/. Статичний каталог охоплює типові випадки; ідентифікатори поза каталогом переходять до стандартного OpenAI-сумісного шаблону.
{
  agents: {
    defaults: {
      model: { primary: "groq/<your-model-id>" },
    },
  },
}

​
Пов’язане

Провайдери моделей

Вибір провайдерів, посилань на моделі та поведінки failover.

Режими мислення

Рівні зусиль reasoning і взаємодія з політикою провайдера.

Довідник конфігурації

Повна схема конфігурації, зокрема параметри провайдера й аудіо.

Консоль Groq

Панель керування Groq, документація API та ціни.