moltbot/docs/providers/groq.md

title, summary, read_when

title	summary	read_when
Groq	Groq setup (auth + model selection)	You want to use Groq with OpenClaw You need the API key env var or CLI auth choice

Groq

Groq provides ultra-fast inference on open-source models (Llama, Gemma, Mistral, and more) using custom LPU hardware. OpenClaw connects to Groq through its OpenAI-compatible API.

Property	Value
Provider	groq
Auth	GROQ_API_KEY
API	OpenAI-compatible

Getting started

Create an API key at [console.groq.com/keys](https://console.groq.com/keys). ```bash export GROQ_API_KEY="gsk_..." ``` ```json5 { agents: { defaults: { model: { primary: "groq/llama-3.3-70b-versatile" }, }, }, } ```

Config file example

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

Available models

Groq's model catalog changes frequently. Run openclaw models list | grep groq to see currently available models, or check console.groq.com/docs/models.

Model	Notes
Llama 3.3 70B Versatile	General-purpose, large context
Llama 3.1 8B Instant	Fast, lightweight
Gemma 2 9B	Compact, efficient
Mixtral 8x7B	MoE architecture, strong reasoning

Use `openclaw models list --provider groq` for the most up-to-date list of models available on your account.

Audio transcription

Groq also provides fast Whisper-based audio transcription. When configured as a media-understanding provider, OpenClaw uses Groq's whisper-large-v3-turbo model to transcribe voice messages through the shared tools.media.audio surface.

{
  tools: {
    media: {
      audio: {
        models: [{ provider: "groq" }],
      },
    },
  },
}

| Property | Value | |----------|-------| | Shared config path | `tools.media.audio` | | Default base URL | `https://api.groq.com/openai/v1` | | Default model | `whisper-large-v3-turbo` | | API endpoint | OpenAI-compatible `/audio/transcriptions` | If the Gateway runs as a daemon (launchd/systemd), make sure `GROQ_API_KEY` is available to that process (for example, in `~/.openclaw/.env` or via `env.shellEnv`).

<Warning>
Keys set only in your interactive shell are not visible to daemon-managed
gateway processes. Use `~/.openclaw/.env` or `env.shellEnv` config for
persistent availability.
</Warning>

Related

Choosing providers, model refs, and failover behavior. Full config schema including provider and audio settings. Groq dashboard, API docs, and pricing. Official Groq model catalog.