Zum Hauptinhalt springen
Groq bietet ultraschnelle Inferenz auf Open-Weight-Modellen (Llama, Gemma, Kimi, Qwen, GPT OSS und mehr) mit benutzerdefinierter LPU-Hardware. Das Groq-Plugin registriert sowohl einen OpenAI-kompatiblen Chat-Provider als auch einen Provider für Audio-Medienverständnis.
EigenschaftWert
Provider-IDgroq
Pluginoffizielles externes Paket
Auth-UmgebungsvariableGROQ_API_KEY
APIOpenAI-kompatibel (openai-completions)
Basis-URLhttps://api.groq.com/openai/v1
Audio-Transkriptionwhisper-large-v3-turbo (Standard)
Empfohlener Chat-Standardgroq/llama-3.3-70b-versatile

​
Plugin installieren

Installieren Sie das offizielle Plugin und starten Sie anschließend den Gateway neu: 
openclaw plugins install @openclaw/groq-provider
openclaw gateway restart

​
Erste Schritte

1

API-Schlüssel abrufen

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

API-Schlüssel festlegen

export GROQ_API_KEY=gsk_...
3

Standardmodell festlegen

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

Prüfen, ob der Katalog erreichbar ist

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 liefert einen manifestgestützten Groq-Katalog mit Reasoning- und Nicht-Reasoning-Einträgen aus. Führen Sie openclaw models list --provider groq aus, um die statischen Zeilen Ihrer installierten Version anzuzeigen, oder prüfen Sie console.groq.com/docs/models für Groqs maßgebliche Liste.
ModellreferenzNameReasoningEingabeKontext
groq/llama-3.3-70b-versatileLlama 3.3 70B VersatileneinText131,072
groq/llama-3.1-8b-instantLlama 3.1 8B InstantneinText131,072
groq/meta-llama/llama-4-scout-17b-16e-instructLlama 4 Scout 17BneinText + Bild131,072
groq/openai/gpt-oss-120bGPT OSS 120BjaText131,072
groq/openai/gpt-oss-20bGPT OSS 20BjaText131,072
groq/openai/gpt-oss-safeguard-20bSafety GPT OSS 20BjaText131,072
groq/qwen/qwen3-32bQwen3 32BjaText131,072
groq/groq/compoundCompoundjaText131,072
groq/groq/compound-miniCompound MinijaText131,072
Der Katalog entwickelt sich mit jeder OpenClaw-Version weiter. openclaw models list --provider groq zeigt die Zeilen, die Ihrer installierten Version bekannt sind; gleichen Sie dies mit console.groq.com/docs/models ab, um neu hinzugefügte oder veraltete Modelle zu prüfen.

​
Reasoning-Modelle

OpenClaw ordnet seine gemeinsamen /think-Stufen den modellspezifischen reasoning_effort-Werten von Groq zu:
  • Für qwen/qwen3-32b sendet deaktiviertes Denken none und aktiviertes Denken default.
  • Für Groq-GPT-OSS-Reasoning-Modelle (openai/gpt-oss-*) sendet OpenClaw je nach /think-Stufe low, medium oder high. Bei deaktiviertem Denken wird reasoning_effort ausgelassen, da diese Modelle keinen deaktivierten Wert unterstützen.
  • DeepSeek R1 Distill, Qwen QwQ und Compound verwenden Groqs native Reasoning-Oberfläche; /think steuert die Sichtbarkeit, aber das Modell denkt immer.
Siehe Denkmodi für die gemeinsamen /think-Stufen und wie OpenClaw sie pro Provider übersetzt.

​
Audio-Transkription

Das Groq-Plugin registriert außerdem einen Provider für Audio-Medienverständnis, damit Sprachnachrichten über die gemeinsame Oberfläche tools.media.audio transkribiert werden können.
EigenschaftWert
Gemeinsamer Konfigurationspfadtools.media.audio
Standard-Basis-URLhttps://api.groq.com/openai/v1
Standardmodellwhisper-large-v3-turbo
Automatische Priorität20
API-EndpunktOpenAI-kompatibel /audio/transcriptions
So machen Sie Groq zum Standard-Audio-Backend: 
{
  tools: {
    media: {
      audio: {
        models: [{ provider: "groq" }],
      },
    },
  },
}
Wenn der 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 er vom Gateway-Prozess gelesen werden kann.
OpenClaw akzeptiert zur Laufzeit jede Groq-Modell-ID. Verwenden Sie die exakte von Groq angezeigte ID und stellen Sie ihr groq/ voran. Der statische Katalog deckt die üblichen Fälle ab; nicht katalogisierte IDs fallen auf die standardmäßige OpenAI-kompatible Vorlage zurück.
{
  agents: {
    defaults: {
      model: { primary: "groq/<your-model-id>" },
    },
  },
}

​
Verwandte Themen

Modell-Provider

Auswahl von Providern, Modellreferenzen und Failover-Verhalten.

Denkmodi

Reasoning-Aufwandsstufen und Interaktion mit Provider-Richtlinien.

Konfigurationsreferenz

Vollständiges Konfigurationsschema einschließlich Provider- und Audio-Einstellungen.

Groq Console

Groq-Dashboard, API-Dokumentation und Preise.