Przejdź do głównej treści

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 zapewnia ultraszybką inferencję na modelach o otwartych wagach (Llama, Gemma, Kimi, Qwen, GPT OSS i innych) przy użyciu niestandardowego sprzętu LPU. OpenClaw zawiera dołączony Plugin Groq, który rejestruje zarówno dostawcę czatu zgodnego z OpenAI, jak i dostawcę rozumienia multimediów audio.
WłaściwośćWartość
Identyfikator dostawcygroq
Plugindołączony, enabledByDefault: true
Zmienna środowiskowa authGROQ_API_KEY
Flaga onboardingu--auth-choice groq-api-key
APIzgodne z OpenAI (openai-completions)
Bazowy URLhttps://api.groq.com/openai/v1
Transkrypcja audiowhisper-large-v3-turbo (domyślnie)
Sugerowany domyślny czatgroq/llama-3.3-70b-versatile

Pierwsze kroki

1

Uzyskaj klucz API

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

Ustaw klucz API

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

Ustaw model domyślny

{
  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 wpisami obsługującymi rozumowanie i bez rozumowania. Uruchom openclaw models list --provider groq, aby zobaczyć dołączone wiersze dla zainstalowanej wersji, albo sprawdź console.groq.com/docs/models, aby uzyskać autorytatywną listę Groq.
Referencja modeluNazwaRozumowanieWejścieKontekst
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-maverick-17b-128e-instructLlama 4 Maverick 17Bnietekst + obraz131,072
groq/meta-llama/llama-4-scout-17b-16e-instructLlama 4 Scout 17Bnietekst + obraz131,072
groq/llama3-70b-8192Llama 3 70Bnietekst8,192
groq/llama3-8b-8192Llama 3 8Bnietekst8,192
groq/gemma2-9b-itGemma 2 9Bnietekst8,192
groq/mistral-saba-24bMistral Saba 24Bnietekst32,768
groq/moonshotai/kimi-k2-instructKimi K2 Instructnietekst131,072
groq/moonshotai/kimi-k2-instruct-0905Kimi K2 Instruct 0905nietekst262,144
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-qwq-32bQwen QwQ 32Btaktekst131,072
groq/qwen/qwen3-32bQwen3 32Btaktekst131,072
groq/deepseek-r1-distill-llama-70bDeepSeek R1 Distill Llama 70Btaktekst131,072
groq/groq/compoundCompoundtaktekst131,072
groq/groq/compound-miniCompound Minitaktekst131,072
Katalog ewoluuje wraz z każdym wydaniem OpenClaw. openclaw models list --provider groq pokazuje wiersze znane zainstalowanej wersji; porównaj je z console.groq.com/docs/models, aby sprawdzić nowo dodane lub wycofane modele.

Modele rozumujące

OpenClaw mapuje swoje współdzielone 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 rozumujących 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łączającej.
  • DeepSeek R1 Distill, Qwen QwQ i Compound używają natywnej powierzchni rozumowania Groq; /think kontroluje widoczność, ale model zawsze rozumuje.
Zobacz Tryby myślenia, aby poznać współdzielone poziomy /think i sposób, w jaki OpenClaw tłumaczy je dla każdego dostawcy.

Transkrypcja audio

Dołączony Plugin Groq rejestruje także dostawcę rozumienia multimediów audio, aby wiadomości głosowe mogły być transkrybowane przez współdzieloną powierzchnię tools.media.audio.
WłaściwośćWartość
Współdzielona ścieżka konfiguracjitools.media.audio
Domyślny bazowy URLhttps://api.groq.com/openai/v1
Model domyślnywhisper-large-v3-turbo
Priorytet automatyczny20
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, a nie tylko dla interaktywnej powłoki.
Klucz znajdujący się tylko w ~/.profile nie pomoże demonowi launchd ani systemd, chyba że to środowisko zostanie tam również zaimportowane. Ustaw klucz w ~/.openclaw/.env lub przez env.shellEnv, aby był czytelny z procesu gateway.
OpenClaw akceptuje w czasie działania dowolny identyfikator modelu Groq. Użyj dokładnego identyfikatora pokazanego przez Groq i poprzedź go prefiksem groq/. Dołączony katalog obejmuje typowe przypadki; nieskatalogowane identyfikatory 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 obejmujący ustawienia dostawcy i audio.

Konsola Groq

Panel Groq, dokumentacja API i ceny.