Перейти до основного вмісту

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Groq надає надшвидкий inference для моделей з відкритими вагами (Llama, Gemma, Kimi, Qwen, GPT OSS тощо) за допомогою спеціального обладнання LPU. OpenClaw містить вбудований Groq plugin, який реєструє і OpenAI-сумісний провайдер чату, і провайдер розуміння аудіомедіа.
ВластивістьЗначення
ID провайдераgroq
Pluginвбудований, enabledByDefault: true
Змінна env для authGROQ_API_KEY
Прапорець onboarding--auth-choice groq-api-key
APIOpenAI-сумісний (openai-completions)
Базова URL-адресаhttps://api.groq.com/openai/v1
Транскрипція аудіоwhisper-large-v3-turbo (за замовчуванням)
Рекомендований типовий чатgroq/llama-3.3-70b-versatile

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

1

Отримайте API-ключ

Створіть API-ключ на console.groq.com/keys.
2

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

openclaw onboard --auth-choice groq-api-key
3

Задайте типову модель

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

Перевірте доступність каталогу

openclaw models list --provider groq

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

{
  env: { GROQ_API_KEY: "gsk_..." },
  agents: {
    defaults: {
      model: { primary: "groq/llama-3.3-70b-versatile" },
    },
  },
}

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

OpenClaw постачається з Groq-каталогом на основі маніфесту, що містить записи як із reasoning, так і без нього. Виконайте openclaw models list --provider groq, щоб переглянути вбудовані рядки для встановленої версії, або перевірте console.groq.com/docs/models, щоб побачити авторитетний список Groq.
Посилання на модельНазваReasoningВхідКонтекст
groq/llama-3.3-70b-versatileLlama 3.3 70B Versatileнітекст131,072
groq/llama-3.1-8b-instantLlama 3.1 8B Instantнітекст131,072
groq/meta-llama/llama-4-maverick-17b-128e-instructLlama 4 Maverick 17Bнітекст + зображення131,072
groq/meta-llama/llama-4-scout-17b-16e-instructLlama 4 Scout 17Bнітекст + зображення131,072
groq/llama3-70b-8192Llama 3 70Bнітекст8,192
groq/llama3-8b-8192Llama 3 8Bнітекст8,192
groq/gemma2-9b-itGemma 2 9Bнітекст8,192
groq/mistral-saba-24bMistral Saba 24Bнітекст32,768
groq/moonshotai/kimi-k2-instructKimi K2 Instructнітекст131,072
groq/moonshotai/kimi-k2-instruct-0905Kimi K2 Instruct 0905нітекст262,144
groq/openai/gpt-oss-120bGPT OSS 120Bтактекст131,072
groq/openai/gpt-oss-20bGPT OSS 20Bтактекст131,072
groq/openai/gpt-oss-safeguard-20bSafety GPT OSS 20Bтактекст131,072
groq/qwen-qwq-32bQwen QwQ 32Bтактекст131,072
groq/qwen/qwen3-32bQwen3 32Bтактекст131,072
groq/deepseek-r1-distill-llama-70bDeepSeek R1 Distill Llama 70Bтактекст131,072
groq/groq/compoundCompoundтактекст131,072
groq/groq/compound-miniCompound Miniтактекст131,072
Каталог змінюється з кожним релізом OpenClaw. openclaw models list --provider groq показує рядки, відомі вашій встановленій версії; звіряйте з console.groq.com/docs/models, щоб дізнатися про новододані або застарілі моделі.

Моделі reasoning

OpenClaw зіставляє свої спільні рівні /think із специфічними для моделей Groq значеннями reasoning_effort:
  • Для qwen/qwen3-32b вимкнене thinking надсилає none, а ввімкнене thinking надсилає default.
  • Для моделей Groq GPT OSS reasoning (openai/gpt-oss-*) OpenClaw надсилає low, medium або high залежно від рівня /think. Вимкнене thinking пропускає reasoning_effort, оскільки ці моделі не підтримують значення для вимкнення.
  • DeepSeek R1 Distill, Qwen QwQ і Compound використовують нативну reasoning-поверхню Groq; /think керує видимістю, але модель завжди міркує.
Див. Режими thinking, щоб дізнатися про спільні рівні /think і те, як OpenClaw перекладає їх для кожного провайдера.

Транскрипція аудіо

Вбудований plugin Groq також реєструє провайдер розуміння аудіомедіа, щоб голосові повідомлення можна було транскрибувати через спільну поверхню tools.media.audio.
ВластивістьЗначення
Спільний шлях конфігураціїtools.media.audio
Типова базова URL-адресаhttps://api.groq.com/openai/v1
Типова модельwhisper-large-v3-turbo
Автоматичний пріоритет20
API endpointOpenAI-сумісний /audio/transcriptions
Щоб зробити Groq типовим backend для аудіо:
{
  tools: {
    media: {
      audio: {
        models: [{ provider: "groq" }],
      },
    },
  },
}
Якщо Gateway працює як керований сервіс (launchd, systemd, Docker), GROQ_API_KEY має бути видимим для цього процесу — не лише для вашої інтерактивної shell.
Ключ, що міститься лише в ~/.profile, не допоможе daemon launchd або systemd, якщо це середовище також не імпортовано туди. Задайте ключ у ~/.openclaw/.env або через env.shellEnv, щоб він був доступний для читання з процесу gateway.
OpenClaw приймає будь-який ID моделі Groq під час виконання. Використовуйте точний ID, який показує Groq, і додайте до нього префікс groq/. Вбудований каталог покриває поширені випадки; некаталогізовані ID переходять до типового OpenAI-сумісного шаблону.
{
  agents: {
    defaults: {
      model: { primary: "groq/<your-model-id>" },
    },
  },
}

Пов’язане

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

Вибір провайдерів, посилань на моделі та поведінки failover.

Режими thinking

Рівні зусилля reasoning і взаємодія політик провайдера.

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

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

Groq Console

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