Naar hoofdinhoud gaan
Groq biedt ultrasnelle inferentie op modellen met open gewichten (Llama, Gemma, Kimi, Qwen, GPT OSS en meer) met aangepaste LPU-hardware. De Groq-Plugin registreert zowel een OpenAI-compatibele chatprovider als een provider voor media-inzicht in audio.
EigenschapWaarde
Provider-idgroq
Pluginofficieel extern pakket
Auth-omgevingsvariabeleGROQ_API_KEY
APIOpenAI-compatibel (openai-completions)
Basis-URLhttps://api.groq.com/openai/v1
Audiotranscriptiewhisper-large-v3-turbo (standaard)
Voorgestelde chatstandaardgroq/llama-3.3-70b-versatile

Plugin installeren

Installeer de officiële Plugin en herstart daarna Gateway:
openclaw plugins install @openclaw/groq-provider
openclaw gateway restart

Aan de slag

1

Get an API key

Maak een API-sleutel aan op console.groq.com/keys.
2

Set the API key

export GROQ_API_KEY=gsk_...
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

Voorbeeld van configuratiebestand

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

Ingebouwde catalogus

OpenClaw levert een door een manifest ondersteunde Groq-catalogus met zowel redenerende als niet-redenerende items. Voer openclaw models list --provider groq uit om de statische rijen voor je geïnstalleerde versie te bekijken, of raadpleeg console.groq.com/docs/models voor Groqs gezaghebbende lijst.
ModelverwijzingNaamRedenerenInvoerContext
groq/llama-3.3-70b-versatileLlama 3.3 70B Versatileneetekst131,072
groq/llama-3.1-8b-instantLlama 3.1 8B Instantneetekst131,072
groq/meta-llama/llama-4-scout-17b-16e-instructLlama 4 Scout 17Bneetekst + afbeelding131,072
groq/openai/gpt-oss-120bGPT OSS 120Bjatekst131,072
groq/openai/gpt-oss-20bGPT OSS 20Bjatekst131,072
groq/openai/gpt-oss-safeguard-20bSafety GPT OSS 20Bjatekst131,072
groq/qwen/qwen3-32bQwen3 32Bjatekst131,072
groq/groq/compoundCompoundjatekst131,072
groq/groq/compound-miniCompound Minijatekst131,072
De catalogus verandert met elke OpenClaw-release. openclaw models list --provider groq toont de rijen die bij je geïnstalleerde versie bekend zijn; controleer dit met console.groq.com/docs/models voor nieuw toegevoegde of verouderde modellen.

Redeneermodellen

OpenClaw koppelt de gedeelde /think-niveaus aan Groqs modelspecifieke reasoning_effort-waarden:
  • Voor qwen/qwen3-32b verzendt uitgeschakeld denken none en ingeschakeld denken default.
  • Voor Groq GPT OSS-redeneermodellen (openai/gpt-oss-*) verzendt OpenClaw low, medium of high op basis van het /think-niveau. Uitgeschakeld denken laat reasoning_effort weg, omdat die modellen geen uitgeschakelde waarde ondersteunen.
  • DeepSeek R1 Distill, Qwen QwQ en Compound gebruiken Groqs native redeneeroppervlak; /think bepaalt de zichtbaarheid, maar het model redeneert altijd.
Zie Denkmodi voor de gedeelde /think-niveaus en hoe OpenClaw ze per provider vertaalt.

Audiotranscriptie

Groqs Plugin registreert ook een provider voor media-inzicht in audio, zodat spraakberichten kunnen worden getranscribeerd via het gedeelde tools.media.audio-oppervlak.
EigenschapWaarde
Gedeeld configuratiepadtools.media.audio
Standaard basis-URLhttps://api.groq.com/openai/v1
Standaardmodelwhisper-large-v3-turbo
Automatische prioriteit20
API-eindpuntOpenAI-compatibel /audio/transcriptions
Om Groq de standaard audio-backend te maken:
{
  tools: {
    media: {
      audio: {
        models: [{ provider: "groq" }],
      },
    },
  },
}
Als Gateway als beheerde service draait (launchd, systemd, Docker), moet GROQ_API_KEY zichtbaar zijn voor dat proces — niet alleen voor je interactieve shell.
Een sleutel die alleen in een interactieve shell is geëxporteerd, helpt een launchd- of systemd-daemon niet, tenzij die omgeving daar ook wordt geïmporteerd. Stel de sleutel in ~/.openclaw/.env in of via env.shellEnv om deze leesbaar te maken vanuit het gatewayproces.
OpenClaw accepteert elke Groq-model-id tijdens runtime. Gebruik de exacte id die Groq toont en voeg er groq/ als prefix aan toe. De statische catalogus dekt de gebruikelijke gevallen; niet-gecatalogiseerde id’s vallen terug op de standaard OpenAI-compatibele template.
{
  agents: {
    defaults: {
      model: { primary: "groq/<your-model-id>" },
    },
  },
}

Gerelateerd

Model providers

Providers, modelverwijzingen en failovergedrag kiezen.

Thinking modes

Niveaus voor redeneerinspanning en interactie met providerbeleid.

Configuration reference

Volledig configuratieschema inclusief provider- en audio-instellingen.

Groq Console

Groq-dashboard, API-documentatie en prijzen.