Groq

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

Властивість	Значення
Ідентифікатор постачальника	`groq`
Plugin	офіційний зовнішній пакет
Змінна середовища автентифікації	`GROQ_API_KEY`
API	сумісний з OpenAI (`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

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

Отримайте ключ 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, щоб переглянути статичні записи для встановленої версії, або зверніться до console.groq.com/docs/models, щоб побачити офіційний список Groq.

Посилання на модель	Назва	Міркування	Вхідні дані	Контекст
`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`	Безпечний 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 перетворює їх для кожного постачальника.

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

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 міг його прочитати.

Власні ідентифікатори моделей Groq

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

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

Пов’язані матеріали

Постачальники моделей

Вибір постачальників, посилань на моделі та поведінки резервного перемикання.

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

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

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

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

Консоль Groq

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

Overview

Concepts and configuration

Providers

Встановлення Plugin

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

Приклад конфігураційного файлу

Вбудований каталог

Моделі з міркуванням

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

Пов’язані матеріали

Постачальники моделей

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

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

Консоль Groq

​Встановлення Plugin

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

​Приклад конфігураційного файлу

​Вбудований каталог

​Моделі з міркуванням

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

​Пов’язані матеріали

Постачальники моделей

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

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

Консоль Groq

Встановлення Plugin

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

Приклад конфігураційного файлу

Вбудований каталог

Моделі з міркуванням

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

Пов’язані матеріали