OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

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:

bash
openclaw plugins install @openclaw/groq-provideropenclaw gateway restart

Primeros pasos

  • Obtener una clave de API

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

  • Establecer la clave de API

    bash
    export GROQ_API_KEY=gsk_...

  • Establecer un modelo predeterminado

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

  • Verificar que el catálogo sea accesible

    bash
    openclaw models list --provider groq

    • Ejemplo de archivo de configuración

    json5
    {  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

    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:

    json5
    {  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.

    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.

    json5
    {  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.
    Was this useful?
    On this page

    On this page