English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisहिन्दीالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiРусскийفارسیไทย
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk 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 multimedia de audio.

Propiedad Valor
ID del proveedor groq
Plugin paquete externo oficial
Variable de entorno de auth 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)
Predeterminado sugerido de chat groq/llama-3.3-70b-versatile

Instalar Plugin

Instala el Plugin oficial y luego reinicia Gateway:

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

Primeros pasos

  • Get an API key

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

  • Set the API key

    bash
    export GROQ_API_KEY=gsk_...

  • Set a default model

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

  • Verify the catalog is reachable

    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 manifiesto con entradas de razonamiento y 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 autorizada de Groq.

    Ref. 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

    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 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 multimedia de audio para que los mensajes de voz puedan transcribirse mediante la superficie 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 compatible con OpenAI /audio/transcriptions

    Para hacer que Groq sea el backend de audio predeterminado:

    json5
    {  tools: {    media: {      audio: {        models: [{ provider: "groq" }],      },    },  },}
    Environment availability for the daemon

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

    Custom Groq model ids

    OpenClaw acepta cualquier ID de modelo de Groq en tiempo de ejecución. Usa el ID exacto que muestra Groq y anteponle groq/. El catálogo estático cubre los casos comunes; los ID no catalogados pasan a la plantilla predeterminada compatible con OpenAI.

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

    Relacionado

    Model providers

    Elección de proveedores, refs. de modelos 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, incluida la configuración de proveedores y audio.
    Groq Console

    Panel de Groq, documentación de API y precios.
    Was this useful?
    On this page

    On this page