Groq

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 mediabegrip van audio.

Eigenschap	Waarde
Provider-id	`groq`
Plugin	officieel extern pakket
Omgevingsvariabele voor authenticatie	`GROQ_API_KEY`
API	OpenAI-compatibel (`openai-completions`)
Basis-URL	`https://api.groq.com/openai/v1`
Audiotranscriptie	`whisper-large-v3-turbo` (standaard)
Voorgestelde standaard voor chat	`groq/llama-3.3-70b-versatile`

Plugin installeren

Installeer de officiële plugin en start daarna de Gateway opnieuw:

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

Aan de slag

Een API-sleutel verkrijgen

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

De API-sleutel instellen

export GROQ_API_KEY=gsk_...

Een standaardmodel instellen

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

Controleren of de catalogus bereikbaar is

openclaw models list --provider groq

Voorbeeld van een configuratiebestand

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

Ingebouwde catalogus

OpenClaw wordt geleverd met een door een manifest ondersteunde Groq-catalogus met zowel modellen met als zonder redeneervermogen. 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 de gezaghebbende lijst van Groq.

Modelreferentie	Naam	Redeneren	Invoer	Context
`groq/llama-3.3-70b-versatile`	Llama 3.3 70B Versatile	nee	tekst	131,072
`groq/llama-3.1-8b-instant`	Llama 3.1 8B Instant	nee	tekst	131,072
`groq/meta-llama/llama-4-scout-17b-16e-instruct`	Llama 4 Scout 17B	nee	tekst + afbeelding	131,072
`groq/openai/gpt-oss-120b`	GPT OSS 120B	ja	tekst	131,072
`groq/openai/gpt-oss-20b`	GPT OSS 20B	ja	tekst	131,072
`groq/openai/gpt-oss-safeguard-20b`	Safety GPT OSS 20B	ja	tekst	131,072
`groq/qwen/qwen3-32b`	Qwen3 32B	ja	tekst	131,072
`groq/groq/compound`	Compound	ja	tekst	131,072
`groq/groq/compound-mini`	Compound Mini	ja	tekst	131,072

De catalogus evolueert met elke OpenClaw-release. openclaw models list --provider groq toont de rijen die bekend zijn bij je geïnstalleerde versie; vergelijk deze met console.groq.com/docs/models voor nieuw toegevoegde of uitgefaseerde modellen.

Redeneermodellen

Groq-redeneermodellen (reasoning: true in de bovenstaande tabel) wijzen de gedeelde /think-niveaus van OpenClaw toe aan reasoning_effort-waarden van low, medium of high. Bij /think off of /think none wordt reasoning_effort uit het verzoek weggelaten in plaats van een uitgeschakelde waarde te verzenden. Zie Denkmodi voor de gedeelde /think-niveaus en hoe OpenClaw deze per provider vertaalt.

Audiotranscriptie

De plugin van Groq registreert ook een provider voor mediabegrip van audio, zodat spraakberichten via het gedeelde tools.media.audio-oppervlak kunnen worden getranscribeerd.

Eigenschap	Waarde
Gedeeld configuratiepad	`tools.media.audio`
Standaardbasis-URL	`https://api.groq.com/openai/v1`
Standaardmodel	`whisper-large-v3-turbo`
Automatische prioriteit	20
API-eindpunt	OpenAI-compatibel `/audio/transcriptions`

Groq instellen als de standaardbackend voor audio:

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

Beschikbaarheid van de omgeving voor de daemon

Als de Gateway als beheerde service wordt uitgevoerd (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 of via env.shellEnv in om deze leesbaar te maken voor het gatewayproces.

Aangepaste Groq-model-id's

OpenClaw accepteert tijdens runtime elke Groq-model-id. Gebruik de exacte id die Groq toont en voeg groq/ als voorvoegsel toe. De statische catalogus omvat de gangbare gevallen; voor id’s die niet in de catalogus staan, wordt teruggevallen op de standaard OpenAI-compatibele sjabloon.

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

Gerelateerd

Modelproviders

Providers, modelreferenties en failovergedrag kiezen.

Denkmodi

Niveaus voor redeneerinspanning en interactie met providerbeleid.

Configuratiereferentie

Volledig configuratieschema, inclusief provider- en audio-instellingen.

Groq Console

Groq-dashboard, API-documentatie en prijzen.

Overview

Concepts and configuration

Providers

Plugin installeren

Aan de slag

Voorbeeld van een configuratiebestand

Ingebouwde catalogus

Redeneermodellen

Audiotranscriptie

Gerelateerd

Modelproviders

Denkmodi

Configuratiereferentie

Groq Console

​Plugin installeren

​Aan de slag

​Voorbeeld van een configuratiebestand

​Ingebouwde catalogus

​Redeneermodellen

​Audiotranscriptie

​Gerelateerd

Modelproviders

Denkmodi

Configuratiereferentie

Groq Console

Plugin installeren

Aan de slag

Voorbeeld van een configuratiebestand

Ingebouwde catalogus

Redeneermodellen

Audiotranscriptie

Gerelateerd