---
read_when:
- Quieres usar Groq con OpenClaw
- Necesitas la variable de entorno de la clave de API o la opción de autenticación de la CLI
- Está configurando la transcripción de audio de Whisper en Groq
summary: Configuración de Groq (autenticación + selección de modelo + transcripción con Whisper)
title: Groq
x-i18n:
generated_at: "2026-06-27T12:38:00Z"
model: gpt-5.5
postprocess_version: locale-links-v1
provider: openai
source_hash: f1133f2b1fa09e2e854b5762e189233597e86e8ccb2df8d619e891b4dc9c8d82
source_path: providers/groq.md
workflow: 16
---
[Groq](https://groq.com) proporciona inferencia ultrarrápida en modelos de pesos abiertos (Llama, Gemma, Kimi, Qwen, GPT OSS y más) mediante hardware LPU personalizado. El Plugin de Groq registra tanto un proveedor de chat compatible con OpenAI como un proveedor de comprensión multimedia de audio.
| Propiedad | Valor |
| -------------------------- | ---------------------------------------- |
| ID del proveedor | `groq` |
| Plugin | paquete externo oficial |
| Variable de entorno de auth | `GROQ_API_KEY` |
| API | compatible con OpenAI (`openai-completions`) |
| URL base | `https://api.groq.com/openai/v1` |
| Transcripción de audio | `whisper-large-v3-turbo` (predeterminado) |
| Predeterminado sugerido de chat | `groq/llama-3.3-70b-versatile` |
## Instalar Plugin
Instala el Plugin oficial y luego reinicia Gateway:
```bash
openclaw plugins install @openclaw/groq-provider
openclaw gateway restart
```
## Primeros pasos
Crea una clave de API en [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" },
},
},
}
```
```bash
openclaw models list --provider groq
```
### Ejemplo de archivo de configuración
```json5
{
env: { GROQ_API_KEY: "gsk_..." },
agents: {
defaults: {
model: { primary: "groq/llama-3.3-70b-versatile" },
},
},
}
```
## Catálogo integrado
OpenClaw incluye un catálogo de Groq respaldado por manifiesto con entradas de razonamiento y sin razonamiento. Ejecuta `openclaw models list --provider groq` para ver las filas estáticas de tu versión instalada, o consulta [console.groq.com/docs/models](https://console.groq.com/docs/models) para ver la lista autorizada de Groq.
| Ref. del modelo | Nombre | Razonamiento | Entrada | Contexto |
| ------------------------------------------------ | ----------------------- | ------------ | -------------- | -------- |
| `groq/llama-3.3-70b-versatile` | Llama 3.3 70B Versatile | no | texto | 131,072 |
| `groq/llama-3.1-8b-instant` | Llama 3.1 8B Instant | no | texto | 131,072 |
| `groq/meta-llama/llama-4-scout-17b-16e-instruct` | Llama 4 Scout 17B | no | texto + imagen | 131,072 |
| `groq/openai/gpt-oss-120b` | GPT OSS 120B | sí | texto | 131,072 |
| `groq/openai/gpt-oss-20b` | GPT OSS 20B | sí | texto | 131,072 |
| `groq/openai/gpt-oss-safeguard-20b` | Safety GPT OSS 20B | sí | texto | 131,072 |
| `groq/qwen/qwen3-32b` | Qwen3 32B | sí | texto | 131,072 |
| `groq/groq/compound` | Compound | sí | texto | 131,072 |
| `groq/groq/compound-mini` | Compound Mini | sí | texto | 131,072 |
El catálogo evoluciona con cada versión de OpenClaw. `openclaw models list --provider groq` muestra las filas conocidas por tu versión instalada; contrástalo con [console.groq.com/docs/models](https://console.groq.com/docs/models) para ver modelos recién añadidos o obsoletos.
## Modelos de razonamiento
OpenClaw asigna sus niveles compartidos de `/think` a los valores `reasoning_effort` específicos del modelo de Groq:
- Para `qwen/qwen3-32b`, el pensamiento desactivado envía `none` y el pensamiento activado envía `default`.
- Para los modelos de razonamiento GPT OSS de Groq (`openai/gpt-oss-*`), OpenClaw envía `low`, `medium` o `high` según el nivel de `/think`. El pensamiento desactivado omite `reasoning_effort` porque esos modelos no admiten un valor desactivado.
- DeepSeek R1 Distill, Qwen QwQ y Compound usan la superficie de razonamiento nativa de Groq; `/think` controla la visibilidad, pero el modelo siempre razona.
Consulta [Modos de pensamiento](/es/tools/thinking) para ver los niveles compartidos de `/think` y cómo OpenClaw los traduce por proveedor.
## Transcripción de audio
El Plugin de Groq también registra un **proveedor de comprensión multimedia de audio** para que los mensajes de voz puedan transcribirse mediante la superficie compartida `tools.media.audio`.
| Propiedad | Valor |
| ----------------------------- | ----------------------------------------- |
| Ruta de configuración compartida | `tools.media.audio` |
| URL base predeterminada | `https://api.groq.com/openai/v1` |
| Modelo predeterminado | `whisper-large-v3-turbo` |
| Prioridad automática | 20 |
| Endpoint de API | compatible con OpenAI `/audio/transcriptions` |
Para hacer que Groq sea el backend de audio predeterminado:
```json5
{
tools: {
media: {
audio: {
models: [{ provider: "groq" }],
},
},
},
}
```
Si Gateway se ejecuta como un servicio administrado (launchd, systemd, Docker), `GROQ_API_KEY` debe ser visible para ese proceso, no solo para tu shell interactiva.
Una clave exportada solo en una shell interactiva no ayudará a un daemon de launchd o systemd a menos que ese entorno también se importe allí. Define la clave en `~/.openclaw/.env` o mediante `env.shellEnv` para que el proceso de gateway pueda leerla.
OpenClaw acepta cualquier ID de modelo de Groq en tiempo de ejecución. Usa el ID exacto que muestra Groq y anteponle `groq/`. El catálogo estático cubre los casos comunes; los ID no catalogados pasan a la plantilla predeterminada compatible con OpenAI.
```json5
{
agents: {
defaults: {
model: { primary: "groq/" },
},
},
}
```
## Relacionado
Elección de proveedores, refs. de modelos y comportamiento de conmutación por error.
Niveles de esfuerzo de razonamiento e interacción con la política del proveedor.
Esquema de configuración completo, incluida la configuración de proveedores y audio.
Panel de Groq, documentación de API y precios.