Pular para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Groq fornece inferência ultrarrápida em modelos de pesos abertos (Llama, Gemma, Kimi, Qwen, GPT OSS e outros) usando hardware LPU personalizado. O OpenClaw inclui um Plugin Groq integrado que 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
Pluginintegrado, enabledByDefault: true
Variável de env de authGROQ_API_KEY
Sinalizador de onboarding--auth-choice groq-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 sugerido para chatgroq/llama-3.3-70b-versatile

​
Primeiros passos

1

Obtenha uma chave de API

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

Defina a chave de API

openclaw onboard --auth-choice groq-api-key
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 integradas da sua versão instalada, ou consulte console.groq.com/docs/models para a lista oficial da Groq.
Ref 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-maverick-17b-128e-instructLlama 4 Maverick 17Bnãotexto + imagem131,072
groq/meta-llama/llama-4-scout-17b-16e-instructLlama 4 Scout 17Bnãotexto + imagem131,072
groq/llama3-70b-8192Llama 3 70Bnãotexto8,192
groq/llama3-8b-8192Llama 3 8Bnãotexto8,192
groq/gemma2-9b-itGemma 2 9Bnãotexto8,192
groq/mistral-saba-24bMistral Saba 24Bnãotexto32,768
groq/moonshotai/kimi-k2-instructKimi K2 Instructnãotexto131,072
groq/moonshotai/kimi-k2-instruct-0905Kimi K2 Instruct 0905nãotexto262,144
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-qwq-32bQwen QwQ 32Bsimtexto131,072
groq/qwen/qwen3-32bQwen3 32Bsimtexto131,072
groq/deepseek-r1-distill-llama-70bDeepSeek R1 Distill Llama 70Bsimtexto131,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 /think compartilhados para os valores reasoning_effort específicos de modelo da Groq:
  • Para qwen/qwen3-32b, o pensamento desativado envia none e o pensamento 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 /think. O pensamento desativado omite reasoning_effort porque esses modelos não oferecem 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.
Veja Modos de pensamento para os níveis /think compartilhados e como o OpenClaw os traduz por provedor.

​
Transcrição de áudio

O Plugin integrado 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 configuração compartilhadotools.media.audio
URL base padrãohttps://api.groq.com/openai/v1
Modelo padrãowhisper-large-v3-turbo
Prioridade automática20
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" }],
      },
    },
  },
}
Se o Gateway for executado como um serviço gerenciado (launchd, systemd, Docker), GROQ_API_KEY deve estar visível para esse processo, não apenas para o seu shell interativo.
Uma chave presente apenas em ~/.profile não ajudará um daemon launchd ou systemd, a menos que esse ambiente também seja importado para lá. Defina 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 runtime. Use o ID exato mostrado pela Groq e prefixe-o com groq/. O catálogo integrado cobre os casos comuns; IDs não catalogados usam o template compatível com OpenAI padrão.
{
  agents: {
    defaults: {
      model: { primary: "groq/<your-model-id>" },
    },
  },
}

​
Relacionados

Provedores de modelos

Escolha de provedores, refs 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 completo de configuração, incluindo configurações de provedor e áudio.

Console Groq

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