OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

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:

bash
openclaw plugins install @openclaw/groq-provideropenclaw gateway restart

Primeiros passos

  • Obter uma chave de API

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

  • Definir a chave de API

    bash
    export GROQ_API_KEY=gsk_...

  • Definir um modelo padrão

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

  • Verificar se o catálogo está acessível

    bash
    openclaw models list --provider groq

    • Exemplo de arquivo de configuração

    json5
    {  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

    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:

    json5
    {  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.

    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.

    json5
    {  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.
    Was this useful?
    On this page

    On this page