Saltar al contenido principal
Groq 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.
PropiedadValor
Id del proveedorgroq
Pluginpaquete externo oficial
Variable de entorno de autenticaciónGROQ_API_KEY
APIcompatible con OpenAI (openai-completions)
URL basehttps://api.groq.com/openai/v1
Transcripción de audiowhisper-large-v3-turbo (predeterminado)
Valor predeterminado de chat sugeridogroq/llama-3.3-70b-versatile

​
Instalar Plugin

Instala el Plugin oficial y luego reinicia Gateway: 
openclaw plugins install @openclaw/groq-provider
openclaw gateway restart

​
Primeros pasos

1

Get an API key

Crea una clave de API en 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" },
    },
  },
}
4

Verify the catalog is reachable

openclaw models list --provider groq

​
Ejemplo de archivo de configuración

{
  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 para ver la lista oficial de Groq.
Ref. del modeloNombreRazonamientoEntradaContexto
groq/llama-3.3-70b-versatileLlama 3.3 70B Versatilenotexto131,072
groq/llama-3.1-8b-instantLlama 3.1 8B Instantnotexto131,072
groq/meta-llama/llama-4-scout-17b-16e-instructLlama 4 Scout 17Bnotexto + imagen131,072
groq/openai/gpt-oss-120bGPT OSS 120Bsítexto131,072
groq/openai/gpt-oss-20bGPT OSS 20Bsítexto131,072
groq/openai/gpt-oss-safeguard-20bSafety GPT OSS 20Bsítexto131,072
groq/qwen/qwen3-32bQwen3 32Bsítexto131,072
groq/groq/compoundCompoundsítexto131,072
groq/groq/compound-miniCompound Minisítexto131,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 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 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.
PropiedadValor
Ruta de configuración compartidatools.media.audio
URL base predeterminadahttps://api.groq.com/openai/v1
Modelo predeterminadowhisper-large-v3-turbo
Prioridad automática20
Endpoint de API/audio/transcriptions compatible con OpenAI
Para hacer que Groq sea el backend de audio predeterminado: 
{
  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.
{
  agents: {
    defaults: {
      model: { primary: "groq/<your-model-id>" },
    },
  },
}

​
Relacionado

Model providers

Elección de proveedores, refs. de modelo y comportamiento de conmutación por error.

Thinking modes

Niveles de esfuerzo de razonamiento e interacción con la política del proveedor.

Configuration reference

Esquema de configuración completo, incluidos los ajustes de proveedores y audio.

Groq Console

Panel de Groq, documentación de API y precios.