Pular para o conteúdo principal
O Groq fornece inferência ultrarrápida em modelos de peso aberto (Llama, Gemma, Kimi, Qwen, GPT OSS e outros) usando hardware LPU personalizado. O plugin Groq registra tanto um provedor de chat compatível com OpenAI quanto um provedor de compreensão de mídia de áudio.
PropriedadeValor
ID do provedorgroq
Pluginpacote externo oficial
Variável de ambiente de authGROQ_API_KEY
APIcompatível com OpenAI (openai-completions)
URL basehttps://api.groq.com/openai/v1
Transcrição de áudiowhisper-large-v3-turbo (padrão)
Padrão de chat sugeridogroq/llama-3.3-70b-versatile

​
Instalar plugin

Instale o plugin oficial e reinicie o Gateway: 
openclaw plugins install @openclaw/groq-provider
openclaw gateway restart

​
Primeiros passos

1

Obtenha uma chave de API

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

Configure a chave de API

export GROQ_API_KEY=gsk_...
3

Defina um modelo padrão

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

Verifique 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 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 a lista oficial da Groq.
Referência do modeloNomeRaciocínioEntradaContexto
groq/llama-3.3-70b-versatileLlama 3.3 70B Versatilenãotexto131,072
groq/llama-3.1-8b-instantLlama 3.1 8B Instantnãotexto131,072
groq/meta-llama/llama-4-scout-17b-16e-instructLlama 4 Scout 17Bnãotexto + imagem131,072
groq/openai/gpt-oss-120bGPT OSS 120Bsimtexto131,072
groq/openai/gpt-oss-20bGPT OSS 20Bsimtexto131,072
groq/openai/gpt-oss-safeguard-20bSafety GPT OSS 20Bsimtexto131,072
groq/qwen/qwen3-32bQwen3 32Bsimtexto131,072
groq/groq/compoundCompoundsimtexto131,072
groq/groq/compound-miniCompound Minisimtexto131,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 modelos recém-adicionados ou descontinuados.

​
Modelos de raciocínio

O OpenClaw mapeia seus níveis compartilhados de /think para os valores reasoning_effort específicos de modelo da Groq:
  • Para qwen/qwen3-32b, raciocínio desativado envia none e raciocínio ativado envia default.
  • Para modelos de raciocínio Groq GPT OSS (openai/gpt-oss-*), o OpenClaw envia low, medium ou high com base no nível de /think. Raciocínio desativado omite reasoning_effort porque esses modelos não dão suporte a um valor desativado.
  • DeepSeek R1 Distill, Qwen QwQ e Compound usam a superfície de raciocínio nativa da Groq; /think controla a visibilidade, mas o modelo sempre raciocina.
Consulte Modos de pensamento para os níveis compartilhados de /think e como o OpenClaw os traduz por provedor.

​
Transcrição de áudio

O plugin da Groq também registra um provedor de compreensão de mídia de áudio para que mensagens de voz possam ser transcritas pela superfície compartilhada tools.media.audio.
PropriedadeValor
Caminho de config compartilhadatools.media.audio
URL base padrãohttps://api.groq.com/openai/v1
Modelo padrãowhisper-large-v3-turbo
Prioridade automática20
Endpoint da APIcompatível com OpenAI /audio/transcriptions
Para tornar a Groq o backend de áudio padrão: 
{
  tools: {
    media: {
      audio: {
        models: [{ provider: "groq" }],
      },
    },
  },
}
Se o Gateway for executado como um serviço gerenciado (launchd, systemd, Docker), GROQ_API_KEY precisa estar visível para esse processo, não apenas para seu shell interativo.
Uma chave exportada apenas em um shell interativo não ajudará um daemon launchd ou systemd, a menos que esse ambiente também seja importado lá. Configure a chave em ~/.openclaw/.env ou via env.shellEnv para torná-la legível pelo processo do gateway.
O OpenClaw aceita qualquer ID de modelo Groq em tempo de execução. Use o ID exato mostrado pela Groq e prefixe-o com groq/. O catálogo estático cobre os casos comuns; IDs não catalogados passam para o modelo compatível com OpenAI padrão.
{
  agents: {
    defaults: {
      model: { primary: "groq/<your-model-id>" },
    },
  },
}

​
Relacionados

Provedores de modelo

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

Modos de pensamento

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 configurações de provedor e áudio.

Groq Console

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