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

Propiedad Valor
Id. de proveedor groq
Plugin integrado, enabledByDefault: true
Variable de entorno de autenticación GROQ_API_KEY
Indicador de incorporación --auth-choice 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 sugerido para chat groq/llama-3.3-70b-versatile

Primeros pasos

  • Obtén una clave de API

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

  • Configura la clave de API

    openclaw onboard --auth-choice groq-api-key
    
    export GROQ_API_KEY=gsk_...
    
  • Configura un modelo predeterminado

    {
      agents: {
        defaults: {
          model: { primary: "groq/llama-3.3-70b-versatile" },
        },
      },
    }
    
  • 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 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-maverick-17b-128e-instruct Llama 4 Maverick 17B no texto + imagen 131,072
    groq/meta-llama/llama-4-scout-17b-16e-instruct Llama 4 Scout 17B no texto + imagen 131,072
    groq/llama3-70b-8192 Llama 3 70B no texto 8,192
    groq/llama3-8b-8192 Llama 3 8B no texto 8,192
    groq/gemma2-9b-it Gemma 2 9B no texto 8,192
    groq/mistral-saba-24b Mistral Saba 24B no texto 32,768
    groq/moonshotai/kimi-k2-instruct Kimi K2 Instruct no texto 131,072
    groq/moonshotai/kimi-k2-instruct-0905 Kimi K2 Instruct 0905 no texto 262,144
    groq/openai/gpt-oss-120b GPT OSS 120B texto 131,072
    groq/openai/gpt-oss-20b GPT OSS 20B texto 131,072
    groq/openai/gpt-oss-safeguard-20b Safety GPT OSS 20B texto 131,072
    groq/qwen-qwq-32b Qwen QwQ 32B texto 131,072
    groq/qwen/qwen3-32b Qwen3 32B texto 131,072
    groq/deepseek-r1-distill-llama-70b DeepSeek R1 Distill Llama 70B texto 131,072
    groq/groq/compound Compound texto 131,072
    groq/groq/compound-mini Compound Mini 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 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.

    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:

    {
      tools: {
        media: {
          audio: {
            models: [{ provider: "groq" }],
          },
        },
      },
    }
    
    Disponibilidad del entorno para el daemon

    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.

    Ids. de modelo Groq personalizados

    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