Providers
Groq
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.
| Propriedade | Valor |
|---|---|
| ID do provedor | groq |
| Plugin | integrado, enabledByDefault: true |
| Variável de env de auth | GROQ_API_KEY |
| Sinalizador de onboarding | --auth-choice 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 sugerido para chat | groq/llama-3.3-70b-versatile |
Primeiros passos
Obtenha uma chave de API
Crie uma chave de API em console.groq.com/keys.
Defina a chave de API
openclaw onboard --auth-choice groq-api-key
export GROQ_API_KEY=gsk_...
Defina um modelo padrão
{
agents: {
defaults: {
model: { primary: "groq/llama-3.3-70b-versatile" },
},
},
}
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 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-maverick-17b-128e-instruct |
Llama 4 Maverick 17B | não | texto + imagem | 131,072 |
groq/meta-llama/llama-4-scout-17b-16e-instruct |
Llama 4 Scout 17B | não | texto + imagem | 131,072 |
groq/llama3-70b-8192 |
Llama 3 70B | não | texto | 8,192 |
groq/llama3-8b-8192 |
Llama 3 8B | não | texto | 8,192 |
groq/gemma2-9b-it |
Gemma 2 9B | não | texto | 8,192 |
groq/mistral-saba-24b |
Mistral Saba 24B | não | texto | 32,768 |
groq/moonshotai/kimi-k2-instruct |
Kimi K2 Instruct | não | texto | 131,072 |
groq/moonshotai/kimi-k2-instruct-0905 |
Kimi K2 Instruct 0905 | não | texto | 262,144 |
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-qwq-32b |
Qwen QwQ 32B | sim | texto | 131,072 |
groq/qwen/qwen3-32b |
Qwen3 32B | sim | texto | 131,072 |
groq/deepseek-r1-distill-llama-70b |
DeepSeek R1 Distill Llama 70B | sim | texto | 131,072 |
groq/groq/compound |
Compound | sim | texto | 131,072 |
groq/groq/compound-mini |
Compound Mini | sim | texto | 131,072 |
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 envianonee o pensamento ativado enviadefault. - Para modelos de raciocínio Groq GPT OSS (
openai/gpt-oss-*), o OpenClaw envialow,mediumouhighcom base no nível/think. O pensamento desativado omitereasoning_effortporque 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;
/thinkcontrola 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.
| 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 de ambiente para o daemon
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.
IDs personalizados de modelos Groq
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
Escolha de provedores, refs de modelo e comportamento de failover.
Níveis de esforço de raciocínio e interação com a política do provedor.
Esquema completo de configuração, incluindo configurações de provedor e áudio.
Painel da Groq, documentação da API e preços.