@@ -1,20 +1,24 @@
11---
2-summary: "Groq setup (auth + model selection)"
2+summary: "Groq setup (auth + model selection + Whisper transcription)"
33title: "Groq"
44read_when:
55 - You want to use Groq with OpenClaw
66 - You need the API key env var or CLI auth choice
7+ - You are configuring Whisper audio transcription on Groq
78---
899-[Groq](https://groq.com) provides ultra-fast inference on open-source models
10-(Llama, Gemma, Mistral, and more) using custom LPU hardware. OpenClaw connects
11-to Groq through its OpenAI-compatible API.
10+[Groq](https://groq.com) provides ultra-fast inference on open-weight models (Llama, Gemma, Kimi, Qwen, GPT OSS, and more) using custom LPU hardware. OpenClaw includes a bundled Groq plugin that registers both an OpenAI-compatible chat provider and an audio media-understanding provider.
121113-| Property | Value |
14-| -------- | ----------------- |
15-| Provider | `groq` |
16-| Auth | `GROQ_API_KEY` |
17-| API | OpenAI-compatible |
12+| Property | Value |
13+| ---------------------- | ---------------------------------------- |
14+| Provider id | `groq` |
15+| Plugin | bundled, `enabledByDefault: true` |
16+| Auth env var | `GROQ_API_KEY` |
17+| Onboarding flag | `--auth-choice groq-api-key` |
18+| API | OpenAI-compatible (`openai-completions`) |
19+| Base URL | `https://api.groq.com/openai/v1` |
20+| Audio transcription | `whisper-large-v3-turbo` (default) |
21+| Suggested chat default | `groq/llama-3.3-70b-versatile` |
18221923## Getting started
2024@@ -23,9 +27,18 @@ to Groq through its OpenAI-compatible API.
2327Create an API key at [console.groq.com/keys](https://console.groq.com/keys).
2428</Step>
2529<Step title="Set the API key">
26-```bash
27-export GROQ_API_KEY="gsk_..."
28-```
30+<CodeGroup>
31+32+```bash Onboarding
33+openclaw onboard --auth-choice groq-api-key
34+```
35+36+```bash Env only
37+export GROQ_API_KEY=gsk_...
38+```
39+40+</CodeGroup>
41+2942</Step>
3043<Step title="Set a default model">
3144```json5
@@ -38,6 +51,11 @@ to Groq through its OpenAI-compatible API.
3851}
3952```
4053</Step>
54+<Step title="Verify the catalog is reachable">
55+```bash
56+openclaw models list --provider groq
57+```
58+</Step>
4159</Steps>
42604361### Config file example
@@ -55,37 +73,56 @@ to Groq through its OpenAI-compatible API.
55735674## Built-in catalog
577558-OpenClaw ships a manifest-backed Groq catalog for fast provider-filtered model
59-listing. Run `openclaw models list --all --provider groq` to see the bundled
60-rows, or check
61-[console.groq.com/docs/models](https://console.groq.com/docs/models).
62-63-| Model | Notes |
64-| --------------------------- | ---------------------------------- |
65-| **Llama 3.3 70B Versatile** | General-purpose, large context |
66-| **Llama 3.1 8B Instant** | Fast, lightweight |
67-| **Gemma 2 9B** | Compact, efficient |
68-| **Mixtral 8x7B** | MoE architecture, strong reasoning |
76+OpenClaw ships a manifest-backed Groq catalog with both reasoning and non-reasoning entries. Run `openclaw models list --provider groq` to see the bundled rows for your installed version, or check [console.groq.com/docs/models](https://console.groq.com/docs/models) for Groq's authoritative list.
77+78+| Model ref | Name | Reasoning | Input | Context |
79+| ---------------------------------------------------- | ----------------------------- | --------- | ------------ | ------- |
80+| `groq/llama-3.3-70b-versatile` | Llama 3.3 70B Versatile | no | text | 131,072 |
81+| `groq/llama-3.1-8b-instant` | Llama 3.1 8B Instant | no | text | 131,072 |
82+| `groq/meta-llama/llama-4-maverick-17b-128e-instruct` | Llama 4 Maverick 17B | no | text + image | 131,072 |
83+| `groq/meta-llama/llama-4-scout-17b-16e-instruct` | Llama 4 Scout 17B | no | text + image | 131,072 |
84+| `groq/llama3-70b-8192` | Llama 3 70B | no | text | 8,192 |
85+| `groq/llama3-8b-8192` | Llama 3 8B | no | text | 8,192 |
86+| `groq/gemma2-9b-it` | Gemma 2 9B | no | text | 8,192 |
87+| `groq/mistral-saba-24b` | Mistral Saba 24B | no | text | 32,768 |
88+| `groq/moonshotai/kimi-k2-instruct` | Kimi K2 Instruct | no | text | 131,072 |
89+| `groq/moonshotai/kimi-k2-instruct-0905` | Kimi K2 Instruct 0905 | no | text | 262,144 |
90+| `groq/openai/gpt-oss-120b` | GPT OSS 120B | yes | text | 131,072 |
91+| `groq/openai/gpt-oss-20b` | GPT OSS 20B | yes | text | 131,072 |
92+| `groq/openai/gpt-oss-safeguard-20b` | Safety GPT OSS 20B | yes | text | 131,072 |
93+| `groq/qwen-qwq-32b` | Qwen QwQ 32B | yes | text | 131,072 |
94+| `groq/qwen/qwen3-32b` | Qwen3 32B | yes | text | 131,072 |
95+| `groq/deepseek-r1-distill-llama-70b` | DeepSeek R1 Distill Llama 70B | yes | text | 131,072 |
96+| `groq/groq/compound` | Compound | yes | text | 131,072 |
97+| `groq/groq/compound-mini` | Compound Mini | yes | text | 131,072 |
69987099<Tip>
71-Use `openclaw models list --all --provider groq` for the manifest-backed Groq
72-rows known to this OpenClaw version.
100+ 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](https://console.groq.com/docs/models) for newly-added or deprecated models.
73101</Tip>
7410275103## Reasoning models
7610477-OpenClaw maps its shared `/think` levels to Groq's model-specific
78-`reasoning_effort` values. For `qwen/qwen3-32b`, disabled thinking sends
79-`none` and enabled thinking sends `default`. For Groq GPT-OSS reasoning models,
80-OpenClaw sends `low`, `medium`, or `high`; disabled thinking omits
81-`reasoning_effort` because those models do not support a disabled value.
105+OpenClaw maps its shared `/think` levels to Groq's model-specific `reasoning_effort` values:
106+107+- For `qwen/qwen3-32b`, disabled thinking sends `none` and enabled thinking sends `default`.
108+- For Groq GPT OSS reasoning models (`openai/gpt-oss-*`), OpenClaw sends `low`, `medium`, or `high` based on `/think` level. Disabled thinking omits `reasoning_effort` because those models do not support a disabled value.
109+- DeepSeek R1 Distill, Qwen QwQ, and Compound use Groq's native reasoning surface; `/think` controls visibility but the model always reasons.
110+111+See [Thinking modes](/tools/thinking) for the shared `/think` levels and how OpenClaw translates them per provider.
8211283113## Audio transcription
8411485-Groq also provides fast Whisper-based audio transcription. When configured as a
86-media-understanding provider, OpenClaw uses Groq's `whisper-large-v3-turbo`
87-model to transcribe voice messages through the shared `tools.media.audio`
88-surface.
115+Groq's bundled plugin also registers an **audio media-understanding provider** so voice messages can be transcribed through the shared `tools.media.audio` surface.
116+117+| Property | Value |
118+| ------------------ | ----------------------------------------- |
119+| Shared config path | `tools.media.audio` |
120+| Default base URL | `https://api.groq.com/openai/v1` |
121+| Default model | `whisper-large-v3-turbo` |
122+| Auto priority | 20 |
123+| API endpoint | OpenAI-compatible `/audio/transcriptions` |
124+125+To make Groq the default audio backend:
8912690127```json5
91128{
@@ -100,42 +137,44 @@ surface.
100137```
101138102139<AccordionGroup>
103-<Accordion title="Audio transcription details">
104-| Property | Value |
105-|----------|-------|
106-| Shared config path | `tools.media.audio` |
107-| Default base URL | `https://api.groq.com/openai/v1` |
108-| Default model | `whisper-large-v3-turbo` |
109-| API endpoint | OpenAI-compatible `/audio/transcriptions` |
110-</Accordion>
111-112-<Accordion title="Environment note">
113-If the Gateway runs as a daemon (launchd/systemd), make sure `GROQ_API_KEY` is
114-available to that process (for example, in `~/.openclaw/.env` or via
115-`env.shellEnv`).
140+<Accordion title="Environment availability for the daemon">
141+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.
116142117143<Warning>
118-Keys set only in your interactive shell are not visible to daemon-managed
119-gateway processes. Use `~/.openclaw/.env` or `env.shellEnv` config for
120-persistent availability.
144+ A key sitting only in `~/.profile` 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.
121145</Warning>
122146123147</Accordion>
148+149+<Accordion title="Custom Groq model ids">
150+OpenClaw accepts any Groq model id at runtime. Use the exact id shown by Groq and prefix it with `groq/`. The bundled catalog covers the common cases; uncatalogued ids fall through to the default OpenAI-compatible template.
151+152+```json5
153+{
154+ agents: {
155+ defaults: {
156+ model: { primary: "groq/<your-model-id>" },
157+ },
158+ },
159+}
160+```
161+162+</Accordion>
124163</AccordionGroup>
125164126165## Related
127166128167<CardGroup cols={2}>
129-<Card title="Model selection" href="/concepts/model-providers" icon="layers">
168+<Card title="Model providers" href="/concepts/model-providers" icon="layers">
130169Choosing providers, model refs, and failover behavior.
131170</Card>
171+<Card title="Thinking modes" href="/tools/thinking" icon="brain">
172+Reasoning effort levels and provider-policy interaction.
173+</Card>
132174<Card title="Configuration reference" href="/gateway/configuration-reference" icon="gear">
133175Full config schema including provider and audio settings.
134176</Card>
135177<Card title="Groq Console" href="https://console.groq.com" icon="arrow-up-right-from-square">
136178Groq dashboard, API docs, and pricing.
137179</Card>
138-<Card title="Groq model list" href="https://console.groq.com/docs/models" icon="list">
139-Official Groq model catalog.
140-</Card>
141180</CardGroup>
此内容由惯性聚合(RSS阅读器)自动聚合整理，仅供阅读参考。 原文来自 — 版权归原作者所有。