OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

Groq

Groq, özel LPU donanımı kullanarak açık ağırlıklı modellerde (Llama, Gemma, Kimi, Qwen, GPT OSS ve daha fazlası) son derece hızlı çıkarım sağlar. Groq Plugin'i hem OpenAI uyumlu bir sohbet sağlayıcısını hem de sesli medya anlama sağlayıcısını kaydeder.

Özellik Değer
Sağlayıcı kimliği groq
Plugin resmi harici paket
Kimlik doğrulama ortam değişkeni GROQ_API_KEY
API OpenAI uyumlu (openai-completions)
Temel URL https://api.groq.com/openai/v1
Ses transkripsiyonu whisper-large-v3-turbo (varsayılan)
Önerilen varsayılan sohbet modeli groq/llama-3.3-70b-versatile

Plugin'i yükleme

Resmi Plugin'i yükleyin, ardından Gateway'i yeniden başlatın:

bash
openclaw plugins install @openclaw/groq-provideropenclaw gateway restart

Başlarken

  • API anahtarı alın

    console.groq.com/keys adresinde bir API anahtarı oluşturun.

  • API anahtarını ayarlayın

    bash
    export GROQ_API_KEY=gsk_...

  • Varsayılan bir model ayarlayın

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

  • Kataloğa erişilebildiğini doğrulayın

    bash
    openclaw models list --provider groq

    • Yapılandırma dosyası örneği

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

    Yerleşik katalog

    OpenClaw, hem akıl yürütme hem de akıl yürütmesiz girdiler içeren, manifest destekli bir Groq kataloğuyla birlikte gelir. Yüklü sürümünüzün statik satırlarını görmek için openclaw models list --provider groq komutunu çalıştırın veya Groq'nun yetkili listesi için console.groq.com/docs/models sayfasına bakın.

    Model referansı Ad Akıl yürütme Girdi Bağlam
    groq/llama-3.3-70b-versatile Llama 3.3 70B Versatile hayır metin 131,072
    groq/llama-3.1-8b-instant Llama 3.1 8B Instant hayır metin 131,072
    groq/meta-llama/llama-4-scout-17b-16e-instruct Llama 4 Scout 17B hayır metin + görsel 131,072
    groq/openai/gpt-oss-120b GPT OSS 120B evet metin 131,072
    groq/openai/gpt-oss-20b GPT OSS 20B evet metin 131,072
    groq/openai/gpt-oss-safeguard-20b Güvenlik GPT OSS 20B evet metin 131,072
    groq/qwen/qwen3-32b Qwen3 32B evet metin 131,072
    groq/groq/compound Compound evet metin 131,072
    groq/groq/compound-mini Compound Mini evet metin 131,072

    Akıl yürütme modelleri

    Groq akıl yürütme modelleri (yukarıdaki tabloda reasoning: true), OpenClaw'ın paylaşılan /think düzeylerini low, medium veya high reasoning_effort değerleriyle eşler. /think off veya /think none, devre dışı bırakılmış bir değer göndermek yerine istekte reasoning_effort alanını kullanmaz.

    Paylaşılan /think düzeyleri ve OpenClaw'ın bunları her sağlayıcı için nasıl dönüştürdüğü hakkında bilgi için Düşünme modları sayfasına bakın.

    Ses transkripsiyonu

    Groq Plugin'i ayrıca sesli mesajların paylaşılan tools.media.audio yüzeyi üzerinden yazıya dökülebilmesi için bir sesli medya anlama sağlayıcısı kaydeder.

    Özellik Değer
    Paylaşılan yapılandırma yolu tools.media.audio
    Varsayılan temel URL https://api.groq.com/openai/v1
    Varsayılan model whisper-large-v3-turbo
    Otomatik öncelik 20
    API uç noktası OpenAI uyumlu /audio/transcriptions

    Groq'yu varsayılan ses arka ucu yapmak için:

    json5
    {  tools: {    media: {      audio: {        models: [{ provider: "groq" }],      },    },  },}
    Arka plan hizmeti için ortam kullanılabilirliği

    Gateway yönetilen bir hizmet olarak çalışıyorsa (launchd, systemd, Docker), GROQ_API_KEY yalnızca etkileşimli kabuğunuz tarafından değil, bu işlem tarafından da görülebilmelidir.

    Özel Groq model kimlikleri

    OpenClaw, çalışma zamanında herhangi bir Groq model kimliğini kabul eder. Groq tarafından gösterilen kimliği aynen kullanın ve başına groq/ ekleyin. Statik katalog yaygın durumları kapsar; katalogda bulunmayan kimlikler varsayılan OpenAI uyumlu şablona aktarılır.

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

    İlgili konular

    Model sağlayıcıları

    Sağlayıcıların, model referanslarının ve yük devretme davranışının seçilmesi.
    Düşünme modları

    Akıl yürütme çabası düzeyleri ve sağlayıcı politikası etkileşimi.
    Yapılandırma başvurusu

    Sağlayıcı ve ses ayarlarını içeren eksiksiz yapılandırma şeması.
    Groq Console

    Groq kontrol paneli, API belgeleri ve fiyatlandırması.
    Was this useful?
    On this page

    On this page