Groq Provider

기준일: 2026-07-26
난이도: 중급
공식 기준: Groq

개요

이 페이지는 OpenClaw Groq provider의 인증, 모델 ref, 온보딩 플래그, 설정 키를 공식 문서 기준으로 정리합니다.

공식 요약: Groq setup (auth + model selection + Whisper transcription)

model ref는 보통 provider/model 형식입니다. API key·endpoint·model id는 아래 원문 값을 그대로 쓰세요. 임의로 키나 엔드포인트를 만들지 마세요.

빠른 참조

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

공식 문서 기반 상세

아래는 공식 providers/groq 문서를 Mintlify 컴포넌트만 정리하고 공통 제목을 한국어로 맞춘 내용입니다. 설정 키, env, model ref, CLI 플래그는 원문 그대로 유지합니다.

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:

openclaw plugins install @openclaw/groq-provider
openclaw gateway restart

시작하기

Get an API key

Create an API key at [console.groq.com/keys](https://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

The catalog evolves with each OpenClaw release. openclaw models list --provider groq shows the rows known to your installed version; cross-check with console.groq.com/docs/models for newly-added or deprecated models.

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.

오디오 전사

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:

{
  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.

A key exported only in an interactive shell will not help a launchd or systemd daemon unless that environment is imported there too. Set the key in ~/.openclaw/.env or via env.shellEnv to make it readable from the gateway process.

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

관련 문서

Choosing providers, model refs, and failover behavior.


Reasoning effort levels and provider-policy interaction.


Full config schema including provider and audio settings.


Groq dashboard, API docs, and pricing.

검증 체크리스트

• openclaw models list --provider groq 로 모델이 보이는지 확인
• 기본 model alias를 agents.defaults.model.primary에 설정했는지 확인
• API key / OAuth / 로컬 런타임 인증 경로를 공식 문서와 대조했는지 확인
• failover 시 데이터가 다른 provider로 이동할 수 있는지 검토

관련

• Provider 목록 인덱스
• 로컬 모델과 Provider
• 공식: Provider directory, Model providers