> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Groq
[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 de medios de audio.
| Propiedad | Valor |
| ------------------------------------- | -------------------------------------------- |
| Id del proveedor | `groq` |
| Plugin | paquete externo oficial |
| Variable de entorno de autenticación | `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) |
| Valor predeterminado de chat sugerido | `groq/llama-3.3-70b-versatile` |
## Instalar Plugin
Instala el Plugin oficial y luego reinicia Gateway:
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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 theme={"theme":{"light":"min-light","dark":"min-dark"}}
export GROQ_API_KEY=gsk_...
```
```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
agents: {
defaults: {
model: { primary: "groq/llama-3.3-70b-versatile" },
},
},
}
```
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw models list --provider groq
```
### Ejemplo de archivo de configuración
```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
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 tanto de razonamiento como 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 oficial 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 los modelos recién añadidos o en desuso.
## Modelos de razonamiento
Los modelos de razonamiento de Groq (`reasoning: true` en la tabla anterior) asignan los niveles compartidos de `/think` de OpenClaw a valores de `reasoning_effort` de `low`, `medium` o `high`. `/think off` o `/think none` omite `reasoning_effort` de la solicitud en lugar de enviar un valor deshabilitado.
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 de medios 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 | `/audio/transcriptions` compatible con OpenAI |
Para hacer que Groq sea el backend de audio predeterminado:
```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
tools: {
media: {
audio: {
models: [{ provider: "groq" }],
},
},
},
}
```
Si Gateway se ejecuta como un servicio gestionado (launchd, systemd, Docker), `GROQ_API_KEY` debe estar visible para ese proceso, no solo para tu shell interactivo.
Una clave exportada solo en un shell interactivo no ayudará a un daemon 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 mostrado por Groq y anteponle `groq/`. El catálogo estático cubre los casos comunes; los ids que no están en el catálogo pasan a la plantilla predeterminada compatible con OpenAI.
```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
agents: {
defaults: {
model: { primary: "groq/" },
},
},
}
```
## Relacionado
Elección de proveedores, refs. de modelo 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, incluidos los ajustes de proveedores y audio.
Panel de Groq, documentación de API y precios.