Groq

Groq oferece inferência ultrarrápida em modelos de pesos abertos (Llama, Gemma, Kimi, Qwen, GPT OSS e outros) usando hardware LPU personalizado. O Plugin da Groq registra tanto um provedor de chat compatível com OpenAI quanto um provedor de compreensão de mídia de áudio.

Propriedade	Valor
ID do provedor	`groq`
Plugin	pacote externo oficial
Variável de ambiente de autenticação	`GROQ_API_KEY`
API	compatível com OpenAI (`openai-completions`)
URL base	`https://api.groq.com/openai/v1`
Transcrição de áudio	`whisper-large-v3-turbo` (padrão)
Padrão de chat sugerido	`groq/llama-3.3-70b-versatile`

Instalar o Plugin

Instale o Plugin oficial e reinicie o Gateway:

openclaw plugins install @openclaw/groq-provider
openclaw gateway restart

Primeiros passos

Obter uma chave de API

Crie uma chave de API em console.groq.com/keys.

Definir a chave de API

export GROQ_API_KEY=gsk_...

Definir um modelo padrão

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

Verificar se o catálogo está acessível

openclaw models list --provider groq

Exemplo de arquivo de configuração

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

Catálogo integrado

O OpenClaw inclui um catálogo da Groq baseado em manifesto, com entradas de raciocínio e sem raciocínio. Execute openclaw models list --provider groq para ver as linhas estáticas da sua versão instalada ou consulte console.groq.com/docs/models para obter a lista oficial da Groq.

Referência do modelo	Nome	Raciocínio	Entrada	Contexto
`groq/llama-3.3-70b-versatile`	Llama 3.3 70B Versatile	não	texto	131,072
`groq/llama-3.1-8b-instant`	Llama 3.1 8B Instant	não	texto	131,072
`groq/meta-llama/llama-4-scout-17b-16e-instruct`	Llama 4 Scout 17B	não	texto + imagem	131,072
`groq/openai/gpt-oss-120b`	GPT OSS 120B	sim	texto	131,072
`groq/openai/gpt-oss-20b`	GPT OSS 20B	sim	texto	131,072
`groq/openai/gpt-oss-safeguard-20b`	Safety GPT OSS 20B	sim	texto	131,072
`groq/qwen/qwen3-32b`	Qwen3 32B	sim	texto	131,072
`groq/groq/compound`	Compound	sim	texto	131,072
`groq/groq/compound-mini`	Compound Mini	sim	texto	131,072

O catálogo evolui a cada versão do OpenClaw. openclaw models list --provider groq mostra as linhas conhecidas pela sua versão instalada; compare com console.groq.com/docs/models para verificar modelos recém-adicionados ou descontinuados.

Modelos de raciocínio

Os modelos de raciocínio da Groq (reasoning: true na tabela acima) mapeiam os níveis compartilhados de /think do OpenClaw para valores de reasoning_effort como low, medium ou high. /think off ou /think none omite reasoning_effort da solicitação, em vez de enviar um valor desativado. Consulte Modos de raciocínio para conhecer os níveis compartilhados de /think e como o OpenClaw os traduz para cada provedor.

Transcrição de áudio

O Plugin da Groq também registra um provedor de compreensão de mídia de áudio, permitindo que mensagens de voz sejam transcritas por meio da interface compartilhada tools.media.audio.

Propriedade	Valor
Caminho de configuração compartilhado	`tools.media.audio`
URL base padrão	`https://api.groq.com/openai/v1`
Modelo padrão	`whisper-large-v3-turbo`
Prioridade automática	20
Endpoint da API	`/audio/transcriptions` compatível com OpenAI

Para tornar a Groq o backend de áudio padrão:

{
  tools: {
    media: {
      audio: {
        models: [{ provider: "groq" }],
      },
    },
  },
}

Disponibilidade do ambiente para o daemon

Se o Gateway for executado como um serviço gerenciado (launchd, systemd, Docker), GROQ_API_KEY deverá estar visível para esse processo — não apenas para seu shell interativo.

Uma chave exportada somente em um shell interativo não estará disponível para um daemon do launchd ou systemd, a menos que esse ambiente também seja importado nele. Defina a chave em ~/.openclaw/.env ou por meio de env.shellEnv para que ela possa ser lida pelo processo do Gateway.

IDs personalizados de modelos da Groq

O OpenClaw aceita qualquer ID de modelo da Groq em tempo de execução. Use o ID exato exibido pela Groq e adicione o prefixo groq/. O catálogo estático abrange os casos comuns; IDs não catalogados usam o modelo padrão compatível com OpenAI.

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

Relacionados

Provedores de modelos

Escolha de provedores, referências de modelos e comportamento de failover.

Modos de raciocínio

Níveis de esforço de raciocínio e interação com a política do provedor.

Referência de configuração

Esquema de configuração completo, incluindo definições de provedor e áudio.

Console da Groq

Painel da Groq, documentação da API e preços.

Overview

Concepts and configuration

Providers

Instalar o Plugin

Primeiros passos

Exemplo de arquivo de configuração

Catálogo integrado

Modelos de raciocínio

Transcrição de áudio

Relacionados

Provedores de modelos

Modos de raciocínio

Referência de configuração

Console da Groq

​Instalar o Plugin

​Primeiros passos

​Exemplo de arquivo de configuração

​Catálogo integrado

​Modelos de raciocínio

​Transcrição de áudio

​Relacionados

Provedores de modelos

Modos de raciocínio

Referência de configuração

Console da Groq

Instalar o Plugin

Primeiros passos

Exemplo de arquivo de configuração

Catálogo integrado

Modelos de raciocínio

Transcrição de áudio

Relacionados