> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Groq

[Groq](https://groq.com) предоставляет сверхбыстрый инференс моделей с открытыми весами (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:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins install @openclaw/groq-provider
openclaw gateway restart
```

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

**1. Получите ключ API**

Создайте ключ API на странице [console.groq.com/keys](https://console.groq.com/keys).

**2. Задайте ключ API**

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
export GROQ_API_KEY=gsk_...
```

**3. Задайте модель по умолчанию**

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  agents: {
    defaults: {
      model: { primary: "groq/llama-3.3-70b-versatile" },
    },
  },
}
```

**4. Убедитесь, что каталог доступен**

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw models list --provider groq
```

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

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  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](https://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 |

> [!TIP]
>
> Каталог развивается с каждым выпуском OpenClaw. Команда `openclaw models list --provider groq` показывает строки, известные установленной версии; сверяйтесь со страницей [console.groq.com/docs/models](https://console.groq.com/docs/models), чтобы узнать о недавно добавленных или устаревших моделях.

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

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

Общие уровни `/think` и способы их преобразования OpenClaw для каждого провайдера описаны в разделе [Режимы мышления](https://docs2.openclaw.ai/ru/tools/thinking.md).

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

Плагин Groq также регистрирует **провайдер распознавания аудиоконтента**, позволяющий транскрибировать голосовые сообщения через общий интерфейс `tools.media.audio`.

| Свойство | Значение |
| - | - |
| Общий путь конфигурации | `tools.media.audio` |
| Базовый URL по умолчанию | `https://api.groq.com/openai/v1` |
| Модель по умолчанию | `whisper-large-v3-turbo` |
| Автоматический приоритет | 20 |
| Конечная точка API | совместимая с OpenAI `/audio/transcriptions` |

Чтобы сделать Groq аудиобэкендом по умолчанию:

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  tools: {
    media: {
      audio: {
        models: [{ provider: "groq" }],
      },
    },
  },
}
```

> [accordion] Доступность переменной окружения для фоновой службы
>
> Если Gateway работает как управляемая служба (launchd, systemd, Docker), переменная `GROQ_API_KEY` должна быть доступна этому процессу, а не только интерактивной оболочке.
>
> > [!WARNING]
> >
> > Ключ, экспортированный только в интерактивной оболочке, не будет доступен фоновой службе launchd или systemd, если окружение также не импортировано туда. Задайте ключ в `~/.openclaw/.env` или через `env.shellEnv`, чтобы процесс Gateway мог его прочитать.

> [accordion] Пользовательские идентификаторы моделей Groq
>
> OpenClaw принимает во время выполнения любой идентификатор модели Groq. Используйте точный идентификатор, указанный Groq, добавив к нему префикс `groq/`. Статический каталог охватывает распространённые случаи; для отсутствующих в каталоге идентификаторов используется стандартный шаблон, совместимый с OpenAI.
>
> ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
> {
>   agents: {
>     defaults: {
>       model: { primary: "groq/<your-model-id>" },
>     },
>   },
> }
> ```

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

> [card] [Провайдеры моделей](https://docs2.openclaw.ai/ru/concepts/model-providers.md)
>
> Выбор провайдеров, ссылок на модели и поведения при переключении после сбоя.

> [card] [Режимы мышления](https://docs2.openclaw.ai/ru/tools/thinking.md)
>
> Уровни интенсивности рассуждения и взаимодействие с политиками провайдера.

> [card] [Справочник по конфигурации](https://docs2.openclaw.ai/ru/gateway/configuration-reference.md)
>
> Полная схема конфигурации, включая настройки провайдера и аудио.

> [card] [Консоль Groq](https://console.groq.com)
>
> Панель управления Groq, документация API и тарифы.