Pular para o conteúdo principal

​
Groq

A Groq fornece inferência ultrarrápida em modelos open source (Llama, Gemma, Mistral e outros) usando hardware LPU personalizado. O OpenClaw se conecta ao Groq por meio de sua API compatível com OpenAI.
PropriedadeValor
Provedorgroq
AutenticaçãoGROQ_API_KEY
APICompatível com OpenAI

​
Primeiros passos

1

Obtenha uma chave de API

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

Defina 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" },
    },
  },
}

​
Exemplo de arquivo de configuração

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

​
Modelos disponíveis

O catálogo de modelos do Groq muda com frequência. Execute openclaw models list | grep groq para ver os modelos atualmente disponíveis, ou consulte console.groq.com/docs/models.
ModeloObservações
Llama 3.3 70B VersatileUso geral, contexto amplo
Llama 3.1 8B InstantRápido, leve
Gemma 2 9BCompacto, eficiente
Mixtral 8x7BArquitetura MoE, raciocínio forte
Use openclaw models list --provider groq para obter a lista mais atualizada dos modelos disponíveis na sua conta.

​
Transcrição de áudio

O Groq também fornece transcrição rápida de áudio com base em Whisper. Quando configurado como um provedor de entendimento de mídia, o OpenClaw usa o modelo whisper-large-v3-turbo do Groq para transcrever mensagens de voz por meio da superfície compartilhada tools.media.audio. 
{
  tools: {
    media: {
      audio: {
        models: [{ provider: "groq" }],
      },
    },
  },
}
PropriedadeValor
Caminho compartilhado de configuraçãotools.media.audio
URL base padrãohttps://api.groq.com/openai/v1
Modelo padrãowhisper-large-v3-turbo
Endpoint da APICompatível com OpenAI /audio/transcriptions
Se o Gateway for executado como daemon (launchd/systemd), verifique se GROQ_API_KEY está disponível para esse processo (por exemplo, em ~/.openclaw/.env ou via env.shellEnv).
Chaves definidas apenas no seu shell interativo não ficam visíveis para processos do Gateway gerenciados por daemon. Use ~/.openclaw/.env ou a configuração env.shellEnv para disponibilidade persistente.

​
Relacionados

Seleção de modelo

Escolha de provedores, refs de modelo e comportamento de failover.

Referência de configuração

Esquema completo de configuração, incluindo ajustes de provedor e áudio.

Groq Console

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

Lista de modelos do Groq

Catálogo oficial de modelos do Groq.