Saltar al contenido principal

Groq

Groq ofrece inferencia ultrarrápida en modelos de código abierto (Llama, Gemma, Mistral y más) usando hardware LPU personalizado. OpenClaw se conecta a Groq a través de su API compatible con OpenAI.
PropiedadValor
Proveedorgroq
AutenticaciónGROQ_API_KEY
APICompatible con OpenAI

Primeros pasos

1

Obtén una API key

Crea una API key en console.groq.com/keys.
2

Configura la API key

export GROQ_API_KEY="gsk_..."
3

Establece un modelo predeterminado

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

Ejemplo de archivo de configuración

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

Modelos disponibles

El catálogo de modelos de Groq cambia con frecuencia. Ejecuta openclaw models list | grep groq para ver los modelos disponibles actualmente, o consulta console.groq.com/docs/models.
ModeloNotas
Llama 3.3 70B VersatilePropósito general, contexto amplio
Llama 3.1 8B InstantRápido, ligero
Gemma 2 9BCompacto, eficiente
Mixtral 8x7BArquitectura MoE, razonamiento sólido
Usa openclaw models list --provider groq para obtener la lista más actualizada de modelos disponibles en tu cuenta.

Transcripción de audio

Groq también proporciona transcripción de audio rápida basada en Whisper. Cuando se configura como proveedor de comprensión de medios, OpenClaw usa el modelo whisper-large-v3-turbo de Groq para transcribir mensajes de voz a través de la superficie compartida tools.media.audio.
{
  tools: {
    media: {
      audio: {
        models: [{ provider: "groq" }],
      },
    },
  },
}
PropiedadValor
Ruta de configuración compartidatools.media.audio
URL base predeterminadahttps://api.groq.com/openai/v1
Modelo predeterminadowhisper-large-v3-turbo
Endpoint de API/audio/transcriptions compatible con OpenAI
Si el Gateway se ejecuta como daemon (launchd/systemd), asegúrate de que GROQ_API_KEY esté disponible para ese proceso (por ejemplo, en ~/.openclaw/.env o mediante env.shellEnv).
Las claves configuradas solo en tu shell interactivo no son visibles para los procesos del Gateway administrados por un daemon. Usa ~/.openclaw/.env o la configuración env.shellEnv para disponibilidad persistente.

Relacionado

Selección de modelo

Elegir proveedores, referencias de modelo y comportamiento de conmutación por error.

Referencia de configuración

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

Groq Console

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

Lista de modelos de Groq

Catálogo oficial de modelos de Groq.