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

Providers

Groq

Groq provides ultra-fast inference on open-weight models (Llama, Gemma, Kimi, Qwen, GPT OSS, and more) using custom LPU hardware. The Groq plugin registers both an OpenAI-compatible chat provider and an audio media-understanding provider.

Property Value
Provider id groq
Plugin official external package
Auth env var GROQ_API_KEY
API OpenAI-compatible (openai-completions)
Base URL https://api.groq.com/openai/v1
Audio transcription whisper-large-v3-turbo (default)
Suggested chat default groq/llama-3.3-70b-versatile

Install plugin

Install the official plugin, then restart Gateway:

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

Getting started

  • Get an API key

    Create an API key at console.groq.com/keys.

  • Set the API key

    bash
    export GROQ_API_KEY=gsk_...

  • Set a default model

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

  • Verify the catalog is reachable

    bash
    openclaw models list --provider groq

    • Config file example

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

    Built-in catalog

    OpenClaw ships a manifest-backed Groq catalog with both reasoning and non-reasoning entries. Run openclaw models list --provider groq to see the static rows for your installed version, or check console.groq.com/docs/models for Groq's authoritative list.

    Model ref Name Reasoning Input Context
    groq/llama-3.3-70b-versatile Llama 3.3 70B Versatile no text 131,072
    groq/llama-3.1-8b-instant Llama 3.1 8B Instant no text 131,072
    groq/meta-llama/llama-4-scout-17b-16e-instruct Llama 4 Scout 17B no text + image 131,072
    groq/openai/gpt-oss-120b GPT OSS 120B yes text 131,072
    groq/openai/gpt-oss-20b GPT OSS 20B yes text 131,072
    groq/openai/gpt-oss-safeguard-20b Safety GPT OSS 20B yes text 131,072
    groq/qwen/qwen3-32b Qwen3 32B yes text 131,072
    groq/groq/compound Compound yes text 131,072
    groq/groq/compound-mini Compound Mini yes text 131,072

    Reasoning models

    Groq reasoning models (reasoning: true in the table above) map OpenClaw's shared /think levels onto reasoning_effort values of low, medium, or high. /think off or /think none omits reasoning_effort from the request rather than sending a disabled value.

    See Thinking modes for the shared /think levels and how OpenClaw translates them per provider.

    Audio transcription

    Groq's plugin also registers an audio media-understanding provider so voice messages can be transcribed through the shared tools.media.audio surface.

    Property Value
    Shared config path tools.media.audio
    Default base URL https://api.groq.com/openai/v1
    Default model whisper-large-v3-turbo
    Auto priority 20
    API endpoint OpenAI-compatible /audio/transcriptions

    To make Groq the default audio backend:

    json5
    {  tools: {    media: {      audio: {        models: [{ provider: "groq" }],      },    },  },}
    Environment availability for the daemon

    If the Gateway runs as a managed service (launchd, systemd, Docker), GROQ_API_KEY must be visible to that process — not just to your interactive shell.

    Custom Groq model ids

    OpenClaw accepts any Groq model id at runtime. Use the exact id shown by Groq and prefix it with groq/. The static catalog covers the common cases; uncatalogued ids fall through to the default OpenAI-compatible template.

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

    Choosing providers, model refs, and failover behavior.
    Thinking modes

    Reasoning effort levels and provider-policy interaction.
    Configuration reference

    Full config schema including provider and audio settings.
    Groq Console

    Groq dashboard, API docs, and pricing.
    Was this useful?
    On this page

    On this page