Zum Hauptinhalt springen

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Groq bietet ultraschnelle Inferenz für Open-Weight-Modelle (Llama, Gemma, Kimi, Qwen, GPT OSS und mehr) mit eigener LPU-Hardware. OpenClaw enthält ein gebündeltes Groq-Plugin, das sowohl einen OpenAI-kompatiblen Chat-Provider als auch einen Audio-Medienverständnis-Provider registriert.
EigenschaftWert
Provider-IDgroq
Plugingebündelt, enabledByDefault: true
Auth-UmgebungsvariableGROQ_API_KEY
Onboarding-Flag--auth-choice groq-api-key
APIOpenAI-kompatibel (openai-completions)
Basis-URLhttps://api.groq.com/openai/v1
Audio-Transkriptionwhisper-large-v3-turbo (Standard)
Empfohlener Chat-Standardwertgroq/llama-3.3-70b-versatile

Erste Schritte

1

API-Schlüssel abrufen

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

API-Schlüssel festlegen

openclaw onboard --auth-choice groq-api-key
3

Standardmodell festlegen

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

Erreichbarkeit des Katalogs prü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 liefert einen manifestgestützten Groq-Katalog mit Einträgen für Reasoning und ohne Reasoning aus. Führen Sie openclaw models list --provider groq aus, um die gebündelten Zeilen für Ihre installierte Version anzuzeigen, oder prüfen Sie console.groq.com/docs/models für die maßgebliche Liste von Groq.
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-maverick-17b-128e-instructLlama 4 Maverick 17BneinText + Bild131,072
groq/meta-llama/llama-4-scout-17b-16e-instructLlama 4 Scout 17BneinText + Bild131,072
groq/llama3-70b-8192Llama 3 70BneinText8,192
groq/llama3-8b-8192Llama 3 8BneinText8,192
groq/gemma2-9b-itGemma 2 9BneinText8,192
groq/mistral-saba-24bMistral Saba 24BneinText32,768
groq/moonshotai/kimi-k2-instructKimi K2 InstructneinText131,072
groq/moonshotai/kimi-k2-instruct-0905Kimi K2 Instruct 0905neinText262,144
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-qwq-32bQwen QwQ 32BjaText131,072
groq/qwen/qwen3-32bQwen3 32BjaText131,072
groq/deepseek-r1-distill-llama-70bDeepSeek R1 Distill Llama 70BjaText131,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 die native Reasoning-Oberfläche von Groq; /think steuert die Sichtbarkeit, aber das Modell führt immer Reasoning aus.
Siehe Denkmodi für die gemeinsamen /think-Stufen und wie OpenClaw sie pro Provider übersetzt.

Audio-Transkription

Das gebündelte Plugin von Groq registriert außerdem einen Audio-Medienverständnis-Provider, sodass 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 (launchd, systemd, Docker) läuft, muss GROQ_API_KEY für diesen Prozess sichtbar sein, nicht nur für Ihre interaktive Shell.
Ein Schlüssel, der nur in ~/.profile steht, 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 gebündelte Katalog deckt die gängigen 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

Provider, Modellreferenzen und Failover-Verhalten auswählen.

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.