Providers

Groq

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

Властивість Значення
ID провайдера groq
Plugin вбудований, enabledByDefault: true
Змінна env для auth GROQ_API_KEY
Прапорець onboarding --auth-choice groq-api-key
API OpenAI-сумісний (openai-completions)
Базова URL-адреса https://api.groq.com/openai/v1
Транскрипція аудіо whisper-large-v3-turbo (за замовчуванням)
Рекомендований типовий чат groq/llama-3.3-70b-versatile

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

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

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

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

    openclaw onboard --auth-choice groq-api-key
    
    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-каталогом на основі маніфесту, що містить записи як із reasoning, так і без нього. Виконайте openclaw models list --provider groq, щоб переглянути вбудовані рядки для встановленої версії, або перевірте console.groq.com/docs/models, щоб побачити авторитетний список Groq.

    Посилання на модель Назва Reasoning Вхід Контекст
    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-maverick-17b-128e-instruct Llama 4 Maverick 17B ні текст + зображення 131,072
    groq/meta-llama/llama-4-scout-17b-16e-instruct Llama 4 Scout 17B ні текст + зображення 131,072
    groq/llama3-70b-8192 Llama 3 70B ні текст 8,192
    groq/llama3-8b-8192 Llama 3 8B ні текст 8,192
    groq/gemma2-9b-it Gemma 2 9B ні текст 8,192
    groq/mistral-saba-24b Mistral Saba 24B ні текст 32,768
    groq/moonshotai/kimi-k2-instruct Kimi K2 Instruct ні текст 131,072
    groq/moonshotai/kimi-k2-instruct-0905 Kimi K2 Instruct 0905 ні текст 262,144
    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-qwq-32b Qwen QwQ 32B так текст 131,072
    groq/qwen/qwen3-32b Qwen3 32B так текст 131,072
    groq/deepseek-r1-distill-llama-70b DeepSeek R1 Distill Llama 70B так текст 131,072
    groq/groq/compound Compound так текст 131,072
    groq/groq/compound-mini Compound Mini так текст 131,072

    Моделі 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 endpoint OpenAI-сумісний /audio/transcriptions

    Щоб зробити Groq типовим backend для аудіо:

    {
      tools: {
        media: {
          audio: {
            models: [{ provider: "groq" }],
          },
        },
      },
    }
    
    Доступність середовища для daemon

    Якщо Gateway працює як керований сервіс (launchd, systemd, Docker), GROQ_API_KEY має бути видимим для цього процесу — не лише для вашої інтерактивної shell.

    Власні ID моделей Groq

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

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

    Пов’язане