Groq

Groq bietet ultraschnelle Inferenz für Open-Weight-Modelle (Llama, Gemma, Kimi, Qwen, GPT OSS und weitere) mithilfe spezieller LPU-Hardware. Das Groq-Plugin registriert sowohl einen OpenAI-kompatiblen Chat-Provider als auch einen Provider für das Medienverständnis von Audio.

Eigenschaft	Wert
Provider-ID	`groq`
Plugin	offizielles externes Paket
Umgebungsvariable für die Authentifizierung	`GROQ_API_KEY`
API	OpenAI-kompatibel (`openai-completions`)
Basis-URL	`https://api.groq.com/openai/v1`
Audiotranskription	`whisper-large-v3-turbo` (Standard)
Empfohlenes Standard-Chatmodell	`groq/llama-3.3-70b-versatile`

Plugin installieren

Installieren Sie das offizielle Plugin und starten Sie anschließend das Gateway neu:

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

Erste Schritte

API-Schlüssel abrufen

Erstellen Sie unter console.groq.com/keys einen API-Schlüssel.

API-Schlüssel festlegen

export GROQ_API_KEY=gsk_...

Standardmodell festlegen

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

Erreichbarkeit des Katalogs überprüfen

openclaw models list --provider groq

Beispiel für eine Konfigurationsdatei

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

Integrierter Katalog

OpenClaw wird mit einem manifestgestützten Groq-Katalog ausgeliefert, der sowohl Einträge mit als auch ohne Reasoning enthält. Führen Sie openclaw models list --provider groq aus, um die statischen Zeilen Ihrer installierten Version anzuzeigen, oder prüfen Sie die maßgebliche Liste von Groq unter console.groq.com/docs/models.

Modellreferenz	Name	Reasoning	Eingabe	Kontext
`groq/llama-3.3-70b-versatile`	Llama 3.3 70B Versatile	nein	Text	131,072
`groq/llama-3.1-8b-instant`	Llama 3.1 8B Instant	nein	Text	131,072
`groq/meta-llama/llama-4-scout-17b-16e-instruct`	Llama 4 Scout 17B	nein	Text + Bild	131,072
`groq/openai/gpt-oss-120b`	GPT OSS 120B	ja	Text	131,072
`groq/openai/gpt-oss-20b`	GPT OSS 20B	ja	Text	131,072
`groq/openai/gpt-oss-safeguard-20b`	Safety GPT OSS 20B	ja	Text	131,072
`groq/qwen/qwen3-32b`	Qwen3 32B	ja	Text	131,072
`groq/groq/compound`	Compound	ja	Text	131,072
`groq/groq/compound-mini`	Compound Mini	ja	Text	131,072

Der Katalog entwickelt sich mit jeder OpenClaw-Version weiter. openclaw models list --provider groq zeigt die Einträge, die Ihrer installierten Version bekannt sind. Gleichen Sie diese mit console.groq.com/docs/models ab, um neu hinzugefügte oder veraltete Modelle zu prüfen.

Reasoning-Modelle

Groq-Reasoning-Modelle (reasoning: true in der obigen Tabelle) bilden die gemeinsamen /think-Stufen von OpenClaw auf reasoning_effort-Werte von low, medium oder high ab. Bei /think off oder /think none wird reasoning_effort aus der Anfrage weggelassen, statt einen deaktivierten Wert zu senden. Unter Denkmodi finden Sie Informationen zu den gemeinsamen /think-Stufen und dazu, wie OpenClaw sie für jeden Provider übersetzt.

Audiotranskription

Das Groq-Plugin registriert außerdem einen Provider für das Medienverständnis von Audio, sodass Sprachnachrichten über die gemeinsame tools.media.audio-Schnittstelle transkribiert werden können.

Eigenschaft	Wert
Gemeinsamer Konfigurationspfad	`tools.media.audio`
Standard-Basis-URL	`https://api.groq.com/openai/v1`
Standardmodell	`whisper-large-v3-turbo`
Automatische Priorität	20
API-Endpunkt	OpenAI-kompatibel `/audio/transcriptions`

So legen Sie Groq als standardmäßiges Audio-Backend fest:

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

Verfügbarkeit der Umgebung für den Daemon

Wenn das Gateway als verwalteter Dienst ausgeführt wird (launchd, systemd, Docker), muss GROQ_API_KEY für diesen Prozess sichtbar sein – nicht nur für Ihre interaktive Shell.

Ein nur in einer interaktiven Shell exportierter Schlüssel hilft einem launchd- oder systemd-Daemon nicht, sofern diese Umgebung dort nicht ebenfalls importiert wird. Legen Sie den Schlüssel in ~/.openclaw/.env oder über env.shellEnv fest, damit der Gateway-Prozess darauf zugreifen kann.

Benutzerdefinierte Groq-Modell-IDs

OpenClaw akzeptiert zur Laufzeit jede Groq-Modell-ID. Verwenden Sie die von Groq angezeigte exakte ID und stellen Sie ihr groq/ voran. Der statische Katalog deckt die üblichen Fälle ab; nicht katalogisierte IDs verwenden die OpenAI-kompatible Standardvorlage.

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

Modell-Provider

Auswahl von Providern, Modellreferenzen und Failover-Verhalten.

Denkmodi

Stufen des Reasoning-Aufwands und Zusammenspiel mit Provider-Richtlinien.

Konfigurationsreferenz

Vollständiges Konfigurationsschema einschließlich Provider- und Audioeinstellungen.

Groq Console

Groq-Dashboard, API-Dokumentation und Preise.

Overview

Concepts and configuration

Providers

Plugin installieren

Erste Schritte

Beispiel für eine Konfigurationsdatei

Integrierter Katalog

Reasoning-Modelle

Audiotranskription

Verwandte Themen

Modell-Provider

Denkmodi

Konfigurationsreferenz

Groq Console

​Plugin installieren

​Erste Schritte

​Beispiel für eine Konfigurationsdatei

​Integrierter Katalog

​Reasoning-Modelle

​Audiotranskription

​Verwandte Themen

Modell-Provider

Denkmodi

Konfigurationsreferenz

Groq Console

Plugin installieren

Erste Schritte

Beispiel für eine Konfigurationsdatei

Integrierter Katalog

Reasoning-Modelle

Audiotranskription

Verwandte Themen