Vai al contenuto principale

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 offre inferenza ultra-rapida su modelli a pesi aperti (Llama, Gemma, Kimi, Qwen, GPT OSS e altri) usando hardware LPU personalizzato. OpenClaw include un Plugin Groq in bundle che registra sia un provider di chat compatibile con OpenAI sia un provider di comprensione dei media audio.
ProprietàValore
ID providergroq
Pluginin bundle, enabledByDefault: true
Variabile env authGROQ_API_KEY
Flag di onboarding--auth-choice groq-api-key
APIcompatibile con OpenAI (openai-completions)
URL di basehttps://api.groq.com/openai/v1
Trascrizione audiowhisper-large-v3-turbo (predefinito)
Chat predefinita suggeritagroq/llama-3.3-70b-versatile

​
Introduzione

1

Get an API key

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

Set the API key

openclaw onboard --auth-choice groq-api-key
3

Set a default model

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

Verify the catalog is reachable

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 distribuisce un catalogo Groq basato su manifest con voci sia con ragionamento sia senza ragionamento. Esegui openclaw models list --provider groq per vedere le righe in bundle per la versione installata, oppure consulta console.groq.com/docs/models per l’elenco ufficiale di Groq.
Rif. 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-maverick-17b-128e-instructLlama 4 Maverick 17Bnotesto + immagine131,072
groq/meta-llama/llama-4-scout-17b-16e-instructLlama 4 Scout 17Bnotesto + immagine131,072
groq/llama3-70b-8192Llama 3 70Bnotesto8,192
groq/llama3-8b-8192Llama 3 8Bnotesto8,192
groq/gemma2-9b-itGemma 2 9Bnotesto8,192
groq/mistral-saba-24bMistral Saba 24Bnotesto32,768
groq/moonshotai/kimi-k2-instructKimi K2 Instructnotesto131,072
groq/moonshotai/kimi-k2-instruct-0905Kimi K2 Instruct 0905notesto262,144
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-qwq-32bQwen QwQ 32Bsìtesto131,072
groq/qwen/qwen3-32bQwen3 32Bsìtesto131,072
groq/deepseek-r1-distill-llama-70bDeepSeek R1 Distill Llama 70Bsì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 tua versione installata; confrontale con console.groq.com/docs/models per i modelli aggiunti di recente o deprecati.

​
Modelli con ragionamento

OpenClaw mappa i livelli /think condivisi 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 GPT OSS di Groq (openai/gpt-oss-*), OpenClaw invia low, medium o high in base al livello /think. Il pensiero disabilitato omette reasoning_effort perché questi 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 /think condivisi e per come OpenClaw li traduce per provider.

​
Trascrizione audio

Il Plugin in bundle di Groq registra anche un provider di comprensione dei media audio, così i messaggi vocali possono 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 il 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 presente solo in ~/.profile non sarà utile a un daemon launchd o systemd a meno che anche quell’ambiente non venga importato lì. Imposta la chiave in ~/.openclaw/.env o tramite env.shellEnv per renderla leggibile dal processo Gateway.
OpenClaw accetta qualsiasi ID modello Groq a runtime. Usa l’ID esatto mostrato da Groq e anteponi groq/. Il catalogo in bundle copre i casi comuni; gli ID non presenti nel catalogo ricadono sul modello predefinito compatibile con OpenAI.
{
  agents: {
    defaults: {
      model: { primary: "groq/<your-model-id>" },
    },
  },
}

​
Correlati

Model providers

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

Thinking modes

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

Configuration reference

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

Groq Console

Dashboard Groq, documentazione API e prezzi.