Skip to main content

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 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.
PropertyValue
Providergroq
AuthGROQ_API_KEY
APIOpenAI-compatible

​
Getting started

1

Get an API key

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

Set the API key

export GROQ_API_KEY="gsk_..."
3

Set a default model

{
  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" },
    },
  },
}

​
Built-in catalog

OpenClaw ships a manifest-backed Groq catalog for fast provider-filtered model listing. Run openclaw models list --all --provider groq to see the bundled rows, or check console.groq.com/docs/models.
ModelNotes
Llama 3.3 70B VersatileGeneral-purpose, large context
Llama 3.1 8B InstantFast, lightweight
Gemma 2 9BCompact, efficient
Mixtral 8x7BMoE architecture, strong reasoning
Use openclaw models list --all --provider groq for the manifest-backed Groq rows known to this OpenClaw version.

​
Reasoning models

OpenClaw maps its shared /think levels to Groq’s model-specific reasoning_effort values. For qwen/qwen3-32b, disabled thinking sends none and enabled thinking sends default. For Groq GPT-OSS reasoning models, OpenClaw sends low, medium, or high; disabled thinking omits reasoning_effort because those models do not support a disabled value.

​
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" }],
      },
    },
  },
}
PropertyValue
Shared config pathtools.media.audio
Default base URLhttps://api.groq.com/openai/v1
Default modelwhisper-large-v3-turbo
API endpointOpenAI-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).
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.

Model selection

Choosing providers, model refs, and failover behavior.

Configuration reference

Full config schema including provider and audio settings.

Groq Console

Groq dashboard, API docs, and pricing.

Groq model list

Official Groq model catalog.