Перейти к основному содержанию
Groq обеспечивает сверхбыстрый инференс на моделях с открытыми весами (Llama, Gemma, Kimi, Qwen, GPT OSS и других) с использованием специализированного оборудования LPU. Plugin Groq регистрирует как совместимый с OpenAI провайдер чата, так и провайдер понимания аудиомедиа.
СвойствоЗначение
Идентификатор провайдераgroq
Pluginофициальный внешний пакет
Переменная окружения авторизацииGROQ_API_KEY
APIсовместимый с OpenAI (openai-completions)
Базовый URLhttps://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 на основе манифеста, включающим записи как с рассуждением, так и без него. Выполните openclaw models list --provider groq, чтобы увидеть статические строки для установленной версии, или проверьте console.groq.com/docs/models, чтобы получить авторитетный список Groq.
Ссылка на модельНазваниеРассуждениеВводКонтекст
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, чтобы узнать о недавно добавленных или устаревших моделях.

​
Модели рассуждения

OpenClaw сопоставляет свои общие уровни /think со специфичными для моделей Groq значениями reasoning_effort:
  • Для qwen/qwen3-32b отключенное мышление отправляет none, а включенное мышление отправляет default.
  • Для моделей рассуждения Groq GPT OSS (openai/gpt-oss-*) OpenClaw отправляет low, medium или high на основе уровня /think. При отключенном мышлении 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 должен быть виден этому процессу, а не только вашей интерактивной оболочке.
Ключ, экспортированный только в интерактивной оболочке, не поможет демону launchd или systemd, если это окружение также не импортировано туда. Задайте ключ в ~/.openclaw/.env или через env.shellEnv, чтобы он был доступен для чтения из процесса Gateway.
OpenClaw принимает любой идентификатор модели Groq во время выполнения. Используйте точный идентификатор, показанный Groq, и добавьте к нему префикс groq/. Статический каталог покрывает распространенные случаи; идентификаторы вне каталога переходят к шаблону по умолчанию, совместимому с OpenAI.
{
  agents: {
    defaults: {
      model: { primary: "groq/<your-model-id>" },
    },
  },
}

​
Связанные материалы

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

Выбор провайдеров, ссылок на модели и поведения при отказе.

Режимы мышления

Уровни усилия рассуждения и взаимодействие с политикой провайдера.

Справочник по конфигурации

Полная схема конфигурации, включая настройки провайдеров и аудио.

Groq Console

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