Przejdź do głównej treści
Groq zapewnia ultraszybką inferencję na modelach o otwartych wagach (Llama, Gemma, Kimi, Qwen, GPT OSS i innych) przy użyciu niestandardowego sprzętu LPU. Plugin Groq rejestruje zarówno zgodnego z OpenAI dostawcę czatu, jak i dostawcę rozumienia multimediów audio.
WłaściwośćWartość
Identyfikator dostawcygroq
Pluginoficjalny pakiet zewnętrzny
Zmienna env uwierzytelnianiaGROQ_API_KEY
APIzgodne z OpenAI (openai-completions)
Bazowy URLhttps://api.groq.com/openai/v1
Transkrypcja audiowhisper-large-v3-turbo (domyślnie)
Sugerowana domyślna wartość czatugroq/llama-3.3-70b-versatile

​
Zainstaluj Plugin

Zainstaluj oficjalny Plugin, a następnie uruchom ponownie Gateway: 
openclaw plugins install @openclaw/groq-provider
openclaw gateway restart

​
Pierwsze kroki

1

Uzyskaj klucz API

Utwórz klucz API na stronie console.groq.com/keys.
2

Ustaw klucz API

export GROQ_API_KEY=gsk_...
3

Ustaw domyślny model

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

Sprawdź, czy katalog jest osiągalny

openclaw models list --provider groq

​
Przykład pliku konfiguracyjnego

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

​
Wbudowany katalog

OpenClaw dostarcza oparty na manifeście katalog Groq z pozycjami obsługującymi rozumowanie i bez rozumowania. Uruchom openclaw models list --provider groq, aby zobaczyć statyczne wiersze dla zainstalowanej wersji, albo sprawdź console.groq.com/docs/models, aby uzyskać autorytatywną listę Groq.
Odwołanie do modeluNazwaRozumowanieDane wejścioweKontekst
groq/llama-3.3-70b-versatileLlama 3.3 70B Versatilenietekst131,072
groq/llama-3.1-8b-instantLlama 3.1 8B Instantnietekst131,072
groq/meta-llama/llama-4-scout-17b-16e-instructLlama 4 Scout 17Bnietekst + obraz131,072
groq/openai/gpt-oss-120bGPT OSS 120Btaktekst131,072
groq/openai/gpt-oss-20bGPT OSS 20Btaktekst131,072
groq/openai/gpt-oss-safeguard-20bSafety GPT OSS 20Btaktekst131,072
groq/qwen/qwen3-32bQwen3 32Btaktekst131,072
groq/groq/compoundCompoundtaktekst131,072
groq/groq/compound-miniCompound Minitaktekst131,072
Katalog rozwija się z każdym wydaniem OpenClaw. openclaw models list --provider groq pokazuje wiersze znane zainstalowanej wersji; porównaj z console.groq.com/docs/models, aby sprawdzić nowo dodane lub wycofane modele.

​
Modele rozumowania

OpenClaw mapuje wspólne poziomy /think na specyficzne dla modeli Groq wartości reasoning_effort:
  • Dla qwen/qwen3-32b wyłączone myślenie wysyła none, a włączone myślenie wysyła default.
  • Dla modeli rozumowania Groq GPT OSS (openai/gpt-oss-*) OpenClaw wysyła low, medium lub high na podstawie poziomu /think. Wyłączone myślenie pomija reasoning_effort, ponieważ te modele nie obsługują wartości wyłączonej.
  • DeepSeek R1 Distill, Qwen QwQ i Compound używają natywnego interfejsu rozumowania Groq; /think kontroluje widoczność, ale model zawsze rozumuje.
Zobacz Tryby myślenia, aby poznać wspólne poziomy /think i sposób, w jaki OpenClaw tłumaczy je dla poszczególnych dostawców.

​
Transkrypcja audio

Plugin Groq rejestruje też dostawcę rozumienia multimediów audio, dzięki czemu wiadomości głosowe można transkrybować przez wspólny interfejs tools.media.audio.
WłaściwośćWartość
Wspólna ścieżka konfiguracjitools.media.audio
Domyślny bazowy URLhttps://api.groq.com/openai/v1
Domyślny modelwhisper-large-v3-turbo
Automatyczny priorytet20
Punkt końcowy APIZgodny z OpenAI /audio/transcriptions
Aby ustawić Groq jako domyślny backend audio: 
{
  tools: {
    media: {
      audio: {
        models: [{ provider: "groq" }],
      },
    },
  },
}
Jeśli Gateway działa jako usługa zarządzana (launchd, systemd, Docker), GROQ_API_KEY musi być widoczny dla tego procesu — nie tylko dla interaktywnej powłoki.
Klucz wyeksportowany tylko w interaktywnej powłoce nie pomoże demonowi launchd ani systemd, chyba że to środowisko również zostanie tam zaimportowane. Ustaw klucz w ~/.openclaw/.env lub przez env.shellEnv, aby był odczytywalny z procesu Gateway.
OpenClaw akceptuje w czasie działania dowolny identyfikator modelu Groq. Użyj dokładnego identyfikatora podanego przez Groq i poprzedź go prefiksem groq/. Katalog statyczny obejmuje typowe przypadki; identyfikatory spoza katalogu przechodzą do domyślnego szablonu zgodnego z OpenAI.
{
  agents: {
    defaults: {
      model: { primary: "groq/<your-model-id>" },
    },
  },
}

​
Powiązane

Dostawcy modeli

Wybór dostawców, referencji modeli i zachowania przełączania awaryjnego.

Tryby myślenia

Poziomy wysiłku rozumowania i interakcja z polityką dostawcy.

Dokumentacja konfiguracji

Pełny schemat konfiguracji, w tym ustawienia dostawców i audio.

Groq Console

Panel Groq, dokumentacja API i ceny.