Groq

Groq offre inferenza ultra-rapida su modelli con pesi aperti (Llama, Gemma, Kimi, Qwen, GPT OSS e altri) mediante hardware LPU personalizzato. Il Plugin Groq registra sia un provider di chat compatibile con OpenAI sia un provider per la comprensione di contenuti multimediali audio.

Proprietà	Valore
ID del provider	`groq`
Plugin	pacchetto esterno ufficiale
Variabile di ambiente di autenticazione	`GROQ_API_KEY`
API	compatibile con OpenAI (`openai-completions`)
URL di base	`https://api.groq.com/openai/v1`
Trascrizione audio	`whisper-large-v3-turbo` (predefinito)
Modello di chat predefinito consigliato	`groq/llama-3.3-70b-versatile`

Installare il Plugin

Installa il Plugin ufficiale, quindi riavvia il Gateway:

openclaw plugins install @openclaw/groq-provider
openclaw gateway restart

Introduzione

Ottenere una chiave API

Crea una chiave API all’indirizzo console.groq.com/keys.

Impostare la chiave API

export GROQ_API_KEY=gsk_...

Impostare un modello predefinito

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

Verificare 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 per modelli di ragionamento sia per modelli senza ragionamento. Esegui openclaw models list --provider groq per visualizzare le righe statiche relative alla versione installata oppure consulta console.groq.com/docs/models per l’elenco ufficiale di Groq.

Riferimento del modello	Nome	Ragionamento	Input	Contesto
`groq/llama-3.3-70b-versatile`	Llama 3.3 70B Versatile	no	testo	131,072
`groq/llama-3.1-8b-instant`	Llama 3.1 8B Instant	no	testo	131,072
`groq/meta-llama/llama-4-scout-17b-16e-instruct`	Llama 4 Scout 17B	no	testo + immagine	131,072
`groq/openai/gpt-oss-120b`	GPT OSS 120B	sì	testo	131,072
`groq/openai/gpt-oss-20b`	GPT OSS 20B	sì	testo	131,072
`groq/openai/gpt-oss-safeguard-20b`	Safety GPT OSS 20B	sì	testo	131,072
`groq/qwen/qwen3-32b`	Qwen3 32B	sì	testo	131,072
`groq/groq/compound`	Compound	sì	testo	131,072
`groq/groq/compound-mini`	Compound Mini	sì	testo	131,072

Il catalogo si evolve con ogni versione di OpenClaw. openclaw models list --provider groq mostra le righe note alla versione installata; confrontale con console.groq.com/docs/models per individuare modelli aggiunti di recente o deprecati.

Modelli di ragionamento

I modelli di ragionamento Groq (reasoning: true nella tabella precedente) associano i livelli condivisi di /think di OpenClaw ai valori low, medium o high di reasoning_effort. /think off o /think none omette reasoning_effort dalla richiesta anziché inviare un valore disabilitato. Consulta Modalità di ragionamento per informazioni sui livelli condivisi di /think e su come OpenClaw li traduce per ciascun provider.

Trascrizione audio

Il Plugin Groq registra anche un provider per la comprensione di contenuti multimediali audio, consentendo di trascrivere i messaggi vocali tramite l’interfaccia condivisa tools.media.audio.

Proprietà	Valore
Percorso di configurazione condiviso	`tools.media.audio`
URL di base predefinito	`https://api.groq.com/openai/v1`
Modello predefinito	`whisper-large-v3-turbo`
Priorità automatica	20
Endpoint API	`/audio/transcriptions` compatibile con OpenAI

Per rendere Groq il backend audio predefinito:

{
  tools: {
    media: {
      audio: {
        models: [{ provider: "groq" }],
      },
    },
  },
}

Disponibilità dell'ambiente per il daemon

Se il Gateway viene eseguito come servizio gestito (launchd, systemd, Docker), GROQ_API_KEY deve essere visibile a tale processo, non soltanto alla shell interattiva.

Una chiave esportata esclusivamente in una shell interattiva non sarà disponibile a un daemon launchd o systemd, a meno che l’ambiente non venga importato anche in tale servizio. Imposta la chiave in ~/.openclaw/.env o tramite env.shellEnv per renderla leggibile dal processo del Gateway.

ID personalizzati dei modelli Groq

OpenClaw accetta in fase di esecuzione qualsiasi ID di modello Groq. Usa l’ID esatto indicato da Groq e anteponi groq/. Il catalogo statico copre i casi comuni; gli ID non presenti nel catalogo utilizzano il modello compatibile con OpenAI predefinito.

{
  agents: {
    defaults: {
      model: { primary: "groq/<your-model-id>" },
    },
  },
}

Contenuti correlati

Provider di modelli

Scelta dei provider, dei riferimenti dei modelli e del comportamento di failover.

Modalità di ragionamento

Livelli di intensità del ragionamento e interazione con i criteri del provider.

Riferimento della configurazione

Schema di configurazione completo, incluse le impostazioni del provider e dell’audio.

Console Groq

Dashboard, documentazione API e prezzi di Groq.

Overview

Concepts and configuration

Providers

Installare il Plugin

Introduzione

Esempio di file di configurazione

Catalogo integrato

Modelli di ragionamento

Trascrizione audio

Contenuti correlati

Provider di modelli

Modalità di ragionamento

Riferimento della configurazione

Console Groq

​Installare il Plugin

​Introduzione

​Esempio di file di configurazione

​Catalogo integrato

​Modelli di ragionamento

​Trascrizione audio

​Contenuti correlati

Provider di modelli

Modalità di ragionamento

Riferimento della configurazione

Console Groq

Installare il Plugin

Introduzione

Esempio di file di configurazione

Catalogo integrato

Modelli di ragionamento

Trascrizione audio

Contenuti correlati