Groq

Groq предоставляет сверхбыстрый инференс моделей с открытыми весами (Llama, Gemma, Kimi, Qwen, GPT OSS и других) на специализированном оборудовании LPU. Плагин Groq регистрирует как провайдер чата, совместимый с OpenAI, так и провайдер распознавания аудиоконтента.

Свойство	Значение
Идентификатор провайдера	`groq`
Плагин	официальный внешний пакет
Переменная окружения для аутентификации	`GROQ_API_KEY`
API	совместимый с OpenAI (`openai-completions`)
Базовый URL	`https://api.groq.com/openai/v1`
Транскрибирование аудио	`whisper-large-v3-turbo` (по умолчанию)
Рекомендуемая модель чата по умолчанию	`groq/llama-3.3-70b-versatile`

Установка плагина

Установите официальный плагин, затем перезапустите Gateway:

openclaw plugins install @openclaw/groq-provider
openclaw 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. Команда openclaw models list --provider groq показывает строки, известные установленной версии; сверяйтесь со страницей console.groq.com/docs/models, чтобы узнать о недавно добавленных или устаревших моделях.

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

Модели Groq с рассуждением (reasoning: true в таблице выше) сопоставляют общие уровни /think OpenClaw со значениями reasoning_effort: low, medium или high. При значении /think off или /think none параметр reasoning_effort исключается из запроса, а не отправляется с отключённым значением. Общие уровни /think и способы их преобразования OpenClaw для каждого провайдера описаны в разделе Режимы мышления.

Транскрибирование аудио

Плагин 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 мог его прочитать.

Пользовательские идентификаторы моделей Groq

OpenClaw принимает во время выполнения любой идентификатор модели Groq. Используйте точный идентификатор, указанный Groq, добавив к нему префикс groq/. Статический каталог охватывает распространённые случаи; для отсутствующих в каталоге идентификаторов используется стандартный шаблон, совместимый с OpenAI.

{
  agents: {
    defaults: {
      model: { primary: "groq/<your-model-id>" },
    },
  },
}

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

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

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

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

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

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

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

Консоль Groq

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

Overview

Concepts and configuration

Providers

Установка плагина

Начало работы

Пример файла конфигурации

Встроенный каталог

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

Транскрибирование аудио

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

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

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

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

Консоль Groq

​Установка плагина

​Начало работы

​Пример файла конфигурации

​Встроенный каталог

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

​Транскрибирование аудио

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

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

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

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

Консоль Groq

Установка плагина

Начало работы

Пример файла конфигурации

Встроенный каталог

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

Транскрибирование аудио

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