Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Groq proporciona inferencia ultrarrápida en modelos de pesos abiertos (Llama, Gemma, Kimi, Qwen, GPT OSS y más) mediante hardware LPU personalizado. OpenClaw incluye un Plugin de Groq integrado que registra tanto un proveedor de chat compatible con OpenAI como un proveedor de comprensión de medios de audio.
PropiedadValor
Id. de proveedorgroq
Pluginintegrado, enabledByDefault: true
Variable de entorno de autenticaciónGROQ_API_KEY
Indicador de incorporación--auth-choice groq-api-key
APIcompatible con OpenAI (openai-completions)
URL basehttps://api.groq.com/openai/v1
Transcripción de audiowhisper-large-v3-turbo (predeterminado)
Valor predeterminado sugerido para chatgroq/llama-3.3-70b-versatile

​
Primeros pasos

1

Obtén una clave de API

Crea una clave de API en console.groq.com/keys.
2

Configura la clave de API

openclaw onboard --auth-choice groq-api-key
3

Configura un modelo predeterminado

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

Verifica que se pueda acceder al catálogo

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 integradas de tu versión instalada, o consulta console.groq.com/docs/models para ver la lista oficial de Groq.
Ref. de 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-maverick-17b-128e-instructLlama 4 Maverick 17Bnotexto + imagen131,072
groq/meta-llama/llama-4-scout-17b-16e-instructLlama 4 Scout 17Bnotexto + imagen131,072
groq/llama3-70b-8192Llama 3 70Bnotexto8,192
groq/llama3-8b-8192Llama 3 8Bnotexto8,192
groq/gemma2-9b-itGemma 2 9Bnotexto8,192
groq/mistral-saba-24bMistral Saba 24Bnotexto32,768
groq/moonshotai/kimi-k2-instructKimi K2 Instructnotexto131,072
groq/moonshotai/kimi-k2-instruct-0905Kimi K2 Instruct 0905notexto262,144
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-qwq-32bQwen QwQ 32Bsítexto131,072
groq/qwen/qwen3-32bQwen3 32Bsítexto131,072
groq/deepseek-r1-distill-llama-70bDeepSeek R1 Distill Llama 70Bsítexto131,072
groq/groq/compoundCompoundsítexto131,072
groq/groq/compound-miniCompound Minisítexto131,072
El catálogo evoluciona con cada lanzamiento de OpenClaw. openclaw models list --provider groq muestra las filas conocidas por tu versión instalada; contrástalas con console.groq.com/docs/models para modelos recién agregados o en desuso.

​
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 para conocer los niveles compartidos de /think y cómo OpenClaw los traduce por proveedor.

​
Transcripción de audio

El Plugin integrado de Groq también registra un proveedor de comprensión de medios de audio para que los mensajes de voz se puedan transcribir 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 APIcompatible con OpenAI /audio/transcriptions
Para hacer que Groq sea el backend de audio predeterminado: 
{
  tools: {
    media: {
      audio: {
        models: [{ provider: "groq" }],
      },
    },
  },
}
Si el Gateway se ejecuta como servicio administrado (launchd, systemd, Docker), GROQ_API_KEY debe ser visible para ese proceso, no solo para tu shell interactivo.
Una clave ubicada solo en ~/.profile no ayudará a un daemon de launchd o systemd a menos que ese entorno también se importe allí. Configura la clave en ~/.openclaw/.env o mediante env.shellEnv para que sea legible desde el proceso del gateway.
OpenClaw acepta cualquier id. de modelo de Groq en tiempo de ejecución. Usa el id. exacto que muestra Groq y antepónle el prefijo groq/. El catálogo integrado cubre los casos habituales; los ids. que no están en el catálogo pasan a la plantilla compatible con OpenAI predeterminada.
{
  agents: {
    defaults: {
      model: { primary: "groq/<your-model-id>" },
    },
  },
}

​
Relacionado

Proveedores de modelos

Elegir proveedores, refs. de modelos y comportamiento de conmutación por error.

Modos de pensamiento

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

Referencia de configuración

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

Consola de Groq

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