Groq

Groq zapewnia ultraszybkie wnioskowanie dla modeli z otwartymi wagami (Llama, Gemma, Kimi, Qwen, GPT OSS i innych) przy użyciu niestandardowego sprzętu LPU. Plugin Groq rejestruje zarówno dostawcę czatu zgodnego z OpenAI, jak i dostawcę rozpoznawania zawartości multimediów audio.

Właściwość	Wartość
Identyfikator dostawcy	`groq`
Plugin	oficjalny pakiet zewnętrzny
Zmienna środowiskowa autoryzacji	`GROQ_API_KEY`
API	zgodne z OpenAI (`openai-completions`)
Bazowy adres URL	`https://api.groq.com/openai/v1`
Transkrypcja audio	`whisper-large-v3-turbo` (domyślnie)
Sugerowany domyślny model czatu	`groq/llama-3.3-70b-versatile`

Instalowanie pluginu

Zainstaluj oficjalny plugin, a następnie uruchom ponownie Gateway:

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

Pierwsze kroki

Uzyskaj klucz API

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

Ustaw klucz API

export GROQ_API_KEY=gsk_...

Ustaw model domyślny

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

Sprawdź dostępność katalogu

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 zawiera oparty na manifeście katalog Groq, obejmujący zarówno pozycje z rozumowaniem, jak i bez niego. Uruchom openclaw models list --provider groq, aby wyświetlić statyczne pozycje dla zainstalowanej wersji, lub sprawdź console.groq.com/docs/models, aby poznać oficjalną listę Groq.

Odwołanie do modelu	Nazwa	Rozumowanie	Dane wejściowe	Kontekst
`groq/llama-3.3-70b-versatile`	Llama 3.3 70B Versatile	nie	tekst	131,072
`groq/llama-3.1-8b-instant`	Llama 3.1 8B Instant	nie	tekst	131,072
`groq/meta-llama/llama-4-scout-17b-16e-instruct`	Llama 4 Scout 17B	nie	tekst + obraz	131,072
`groq/openai/gpt-oss-120b`	GPT OSS 120B	tak	tekst	131,072
`groq/openai/gpt-oss-20b`	GPT OSS 20B	tak	tekst	131,072
`groq/openai/gpt-oss-safeguard-20b`	Safety GPT OSS 20B	tak	tekst	131,072
`groq/qwen/qwen3-32b`	Qwen3 32B	tak	tekst	131,072
`groq/groq/compound`	Compound	tak	tekst	131,072
`groq/groq/compound-mini`	Compound Mini	tak	tekst	131,072

Katalog zmienia się z każdym wydaniem OpenClaw. Polecenie openclaw models list --provider groq wyświetla pozycje znane zainstalowanej wersji; porównaj je z console.groq.com/docs/models, aby sprawdzić nowo dodane lub wycofane modele.

Modele rozumujące

Modele rozumujące Groq (reasoning: true w powyższej tabeli) odwzorowują wspólne poziomy /think OpenClaw na wartości reasoning_effort: low, medium lub high. Polecenia /think off lub /think none pomijają reasoning_effort w żądaniu, zamiast wysyłać wartość oznaczającą wyłączenie. 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 również dostawcę rozpoznawania zawartości multimediów audio, dzięki czemu wiadomości głosowe mogą być transkrybowane za pośrednictwem wspólnego interfejsu tools.media.audio.

Właściwość	Wartość
Wspólna ścieżka konfiguracji	`tools.media.audio`
Domyślny bazowy adres URL	`https://api.groq.com/openai/v1`
Domyślny model	`whisper-large-v3-turbo`
Automatyczny priorytet	20
Punkt końcowy API	zgodny z OpenAI `/audio/transcriptions`

Aby ustawić Groq jako domyślny mechanizm obsługi audio:

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

Dostępność środowiska dla demona

Jeśli Gateway działa jako zarządzana usługa (launchd, systemd, Docker), zmienna GROQ_API_KEY musi być widoczna dla tego procesu — nie tylko dla interaktywnej powłoki.

Klucz wyeksportowany wyłącznie w interaktywnej powłoce nie będzie dostępny dla demona launchd ani systemd, chyba że to środowisko zostanie również do niego zaimportowane. Ustaw klucz w ~/.openclaw/.env lub za pomocą env.shellEnv, aby proces Gateway mógł go odczytać.

Niestandardowe identyfikatory modeli Groq

OpenClaw akceptuje podczas działania dowolny identyfikator modelu Groq. Użyj dokładnego identyfikatora podanego przez Groq i poprzedź go prefiksem groq/. Statyczny katalog obejmuje typowe przypadki; identyfikatory spoza katalogu korzystają z domyślnego szablonu zgodnego z OpenAI.

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

Powiązane materiały

Dostawcy modeli

Wybieranie dostawców, odwołań do modeli i sposobu działania mechanizmu przełączania awaryjnego.

Tryby myślenia

Poziomy nakładu na rozumowanie i ich współdziałanie z zasadami dostawcy.

Dokumentacja konfiguracji

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

Konsola Groq

Panel Groq, dokumentacja API i cennik.

Overview

Concepts and configuration

Providers

Instalowanie pluginu

Pierwsze kroki

Przykład pliku konfiguracyjnego

Wbudowany katalog

Modele rozumujące

Transkrypcja audio

Powiązane materiały

Dostawcy modeli

Tryby myślenia

Dokumentacja konfiguracji

Konsola Groq

​Instalowanie pluginu

​Pierwsze kroki

​Przykład pliku konfiguracyjnego

​Wbudowany katalog

​Modele rozumujące

​Transkrypcja audio

​Powiązane materiały

Dostawcy modeli

Tryby myślenia

Dokumentacja konfiguracji

Konsola Groq

Instalowanie pluginu

Pierwsze kroki

Przykład pliku konfiguracyjnego

Wbudowany katalog

Modele rozumujące

Transkrypcja audio

Powiązane materiały