Vai al contenuto principale
Groq fornisce inferenza ultra-rapida su modelli a pesi aperti (Llama, Gemma, Kimi, Qwen, GPT OSS e altri) usando hardware LPU personalizzato. Il Plugin Groq registra sia un provider di chat compatibile con OpenAI sia un provider di comprensione dei media audio.
ProprietàValore
ID providergroq
Pluginpacchetto esterno ufficiale
Variabile env authGROQ_API_KEY
APIcompatibile con OpenAI (openai-completions)
URL di basehttps://api.groq.com/openai/v1
Trascrizione audiowhisper-large-v3-turbo (predefinito)
Default chat suggeritogroq/llama-3.3-70b-versatile

​
Installare il Plugin

Installa il Plugin ufficiale, quindi riavvia Gateway: 
openclaw plugins install @openclaw/groq-provider
openclaw gateway restart

​
Per iniziare

1

Ottieni una chiave API

Crea una chiave API su console.groq.com/keys.
2

Imposta la chiave API

export GROQ_API_KEY=gsk_...
3

Imposta un modello predefinito

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

Verifica che il catalogo sia raggiungibile

openclaw models list --provider groq

​
Esempio di file di configurazione

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

​
Catalogo integrato

OpenClaw include un catalogo Groq basato su manifest con voci sia con ragionamento sia senza ragionamento. Esegui openclaw models list --provider groq per vedere le righe statiche per la versione installata, oppure consulta console.groq.com/docs/models per l’elenco autorevole di Groq.
Ref modelloNomeRagionamentoInputContesto
groq/llama-3.3-70b-versatileLlama 3.3 70B Versatilenotesto131,072
groq/llama-3.1-8b-instantLlama 3.1 8B Instantnotesto131,072
groq/meta-llama/llama-4-scout-17b-16e-instructLlama 4 Scout 17Bnotesto + immagine131,072
groq/openai/gpt-oss-120bGPT OSS 120Bsìtesto131,072
groq/openai/gpt-oss-20bGPT OSS 20Bsìtesto131,072
groq/openai/gpt-oss-safeguard-20bSafety GPT OSS 20Bsìtesto131,072
groq/qwen/qwen3-32bQwen3 32Bsìtesto131,072
groq/groq/compoundCompoundsìtesto131,072
groq/groq/compound-miniCompound Minisìtesto131,072
Il catalogo evolve con ogni release di OpenClaw. openclaw models list --provider groq mostra le righe note alla versione installata; verifica anche console.groq.com/docs/models per i modelli aggiunti di recente o deprecati.

​
Modelli di ragionamento

OpenClaw mappa i suoi livelli condivisi di /think ai valori reasoning_effort specifici del modello di Groq:
  • Per qwen/qwen3-32b, il pensiero disabilitato invia none e il pensiero abilitato invia default.
  • Per i modelli di ragionamento Groq GPT OSS (openai/gpt-oss-*), OpenClaw invia low, medium o high in base al livello di /think. Il pensiero disabilitato omette reasoning_effort perché quei modelli non supportano un valore disabilitato.
  • DeepSeek R1 Distill, Qwen QwQ e Compound usano la superficie di ragionamento nativa di Groq; /think controlla la visibilità, ma il modello ragiona sempre.
Consulta Modalità di pensiero per i livelli condivisi di /think e per come OpenClaw li traduce per ciascun provider.

​
Trascrizione audio

Il Plugin Groq registra anche un provider di comprensione dei media audio in modo che i messaggi vocali possano essere trascritti tramite la superficie condivisa tools.media.audio.
ProprietàValore
Percorso config condivisotools.media.audio
URL di base predefinitohttps://api.groq.com/openai/v1
Modello predefinitowhisper-large-v3-turbo
Priorità automatica20
Endpoint APIcompatibile con OpenAI /audio/transcriptions
Per rendere Groq il backend audio predefinito: 
{
  tools: {
    media: {
      audio: {
        models: [{ provider: "groq" }],
      },
    },
  },
}
Se Gateway viene eseguito come servizio gestito (launchd, systemd, Docker), GROQ_API_KEY deve essere visibile a quel processo, non solo alla tua shell interattiva.
Una chiave esportata solo in una shell interattiva non aiuterà un daemon launchd o systemd, a meno che quell’ambiente non venga importato anche lì. Imposta la chiave in ~/.openclaw/.env o tramite env.shellEnv per renderla leggibile dal processo gateway.
OpenClaw accetta qualsiasi ID modello Groq in fase di runtime. Usa l’ID esatto mostrato da Groq e anteponi groq/. Il catalogo statico copre i casi comuni; gli ID non presenti nel catalogo ricadono sul template predefinito compatibile con OpenAI.
{
  agents: {
    defaults: {
      model: { primary: "groq/<your-model-id>" },
    },
  },
}

​
Correlati

Provider di modelli

Scelta dei provider, delle ref modello e del comportamento di failover.

Modalità di pensiero

Livelli di sforzo di ragionamento e interazione con la policy del provider.

Riferimento configurazione

Schema di configurazione completo, incluse impostazioni di provider e audio.

Groq Console

Dashboard Groq, documentazione API e prezzi.