Groq

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 contenido multimedia 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 el plugin

Instale el plugin oficial y, a continuación, reinicie el Gateway:

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

Primeros pasos

Obtener una clave de API

Cree una clave de API en console.groq.com/keys.

Establecer la clave de API

export GROQ_API_KEY=gsk_...

Establecer un modelo predeterminado

{
  agents: {
    defaults: {
      model: { primary: "groq/llama-3.3-70b-versatile" },
    },
  },
}

Verificar que el catálogo sea accesible

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 un manifiesto, con entradas tanto de razonamiento como sin razonamiento. Ejecute openclaw models list --provider groq para ver las filas estáticas de la versión instalada o consulte console.groq.com/docs/models para obtener la lista oficial de Groq.

Referencia 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 que reconoce la versión instalada; compárelas con console.groq.com/docs/models para consultar los modelos añadidos recientemente 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 desactivado. Consulte Modos de pensamiento para conocer los niveles compartidos de /think y cómo los traduce OpenClaw para cada proveedor.

Transcripción de audio

El plugin de Groq también registra un proveedor de comprensión de contenido multimedia de audio para que los mensajes de voz puedan transcribirse mediante la interfaz 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 establecer Groq como backend de audio predeterminado:

{
  tools: {
    media: {
      audio: {
        models: [{ provider: "groq" }],
      },
    },
  },
}

Disponibilidad del entorno para el daemon

Si el Gateway se ejecuta como un servicio administrado (launchd, systemd, Docker), GROQ_API_KEY debe ser visible para ese proceso, no solo para el shell interactivo.

Una clave exportada únicamente en un shell interactivo no servirá para un daemon de launchd o systemd, salvo que ese entorno también se importe allí. Establezca la clave en ~/.openclaw/.env o mediante env.shellEnv para que el proceso del Gateway pueda leerla.

Id. de modelos de Groq personalizados

OpenClaw acepta cualquier id. de modelo de Groq durante la ejecución. Use el id. exacto que muestra Groq y añada el prefijo groq/. El catálogo estático abarca los casos habituales; los id. no incluidos en el catálogo recurren a la plantilla predeterminada compatible con OpenAI.

{
  agents: {
    defaults: {
      model: { primary: "groq/<your-model-id>" },
    },
  },
}

Contenido relacionado

Proveedores de modelos

Selección de proveedores, referencias de modelos y comportamiento de conmutación por error.

Modos de pensamiento

Niveles de esfuerzo de razonamiento e interacción con las políticas del proveedor.

Referencia de configuración

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

Consola de Groq

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

Overview

Concepts and configuration

Providers

Instalar el plugin

Primeros pasos

Ejemplo de archivo de configuración

Catálogo integrado

Modelos de razonamiento

Transcripción de audio

Contenido relacionado

Proveedores de modelos

Modos de pensamiento

Referencia de configuración

Consola de Groq

​Instalar el plugin

​Primeros pasos

​Ejemplo de archivo de configuración

​Catálogo integrado

​Modelos de razonamiento

​Transcripción de audio

​Contenido relacionado

Proveedores de modelos

Modos de pensamiento

Referencia de configuración

Consola de Groq

Instalar el plugin

Primeros pasos

Ejemplo de archivo de configuración

Catálogo integrado

Modelos de razonamiento

Transcripción de audio

Contenido relacionado