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

Providers

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:

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

Introduzione

  • Ottenere una chiave API

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

  • Impostare la chiave API

    bash
    export GROQ_API_KEY=gsk_...

  • Impostare un modello predefinito

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

  • Verificare che il catalogo sia raggiungibile

    bash
    openclaw models list --provider groq

    • Esempio di file di configurazione

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

    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:

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

    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.

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

    On this page