OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

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:

bash
openclaw plugins install @openclaw/groq-provideropenclaw gateway restart

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

  • Получите ключ API

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

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

    bash
    export GROQ_API_KEY=gsk_...

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

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

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

    bash
    openclaw models list --provider groq

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

    json5
    {  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

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

    Модели 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 аудиобэкендом по умолчанию:

    json5
    {  tools: {    media: {      audio: {        models: [{ provider: "groq" }],      },    },  },}
    Доступность переменной окружения для фоновой службы

    Если Gateway работает как управляемая служба (launchd, systemd, Docker), переменная GROQ_API_KEY должна быть доступна этому процессу, а не только интерактивной оболочке.

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

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

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

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

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

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

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

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

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

    On this page