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. 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:

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, щоб переглянути статичні записи для встановленої версії, або зверніться до 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

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

    Моделі 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 типовим серверним модулем для аудіо:

    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