Groq

Groq, özel LPU donanımı kullanarak açık ağırlıklı modellerde (Llama, Gemma, Kimi, Qwen, GPT OSS ve daha fazlası) ultra hızlı çıkarım sağlar. Groq Plugin’i hem OpenAI uyumlu bir sohbet sağlayıcısını hem de ses medyası 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:

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

Başlarken

API anahtarı alma

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

API anahtarını ayarlama

export GROQ_API_KEY=gsk_...

Varsayılan model ayarlama

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

Kataloğa erişilebildiğini doğrulama

openclaw models list --provider groq

Yapılandırma dosyası örneği

{
  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 özellikli hem de akıl yürütme özelliği olmayan girdiler içeren, manifest destekli bir Groq kataloğuyla birlikte gelir. Yüklü sürümünüze ait statik satırları 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 adresini kontrol edin.

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`	Safety 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

Katalog her OpenClaw sürümüyle birlikte gelişir. openclaw models list --provider groq, yüklü sürümünüzün bildiği satırları gösterir; yeni eklenen veya kullanımdan kaldırılan modeller için console.groq.com/docs/models adresiyle karşılaştırın.

Akıl yürütme modelleri

Groq akıl yürütme modelleri (yukarıdaki tabloda reasoning: true), OpenClaw’un ortak /think düzeylerini low, medium veya high şeklindeki reasoning_effort değerlerine eşler. /think off veya /think none, devre dışı bırakılmış bir değer göndermek yerine reasoning_effort öğesini istekten çıkarır. Ortak /think düzeyleri ve OpenClaw’un bunları her sağlayıcı için nasıl çevirdiği hakkında bilgi edinmek üzere Düşünme modları bölümüne bakın.

Ses transkripsiyonu

Groq Plugin’i ayrıca sesli mesajların ortak tools.media.audio yüzeyi üzerinden yazıya dökülebilmesi için bir ses medyası anlama sağlayıcısı kaydeder.

Özellik	Değer
Ortak 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:

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

Daemon için ortam kullanılabilirliği

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

Yalnızca etkileşimli bir kabukta dışa aktarılan anahtar, söz konusu ortam oraya da aktarılmadıkça launchd veya systemd daemon’una yardımcı olmaz. Anahtarı gateway işlemi tarafından okunabilir hâle getirmek için ~/.openclaw/.env içinde veya env.shellEnv aracılığıyla ayarlayın.

Özel Groq model kimlikleri

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

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

İlgili içerikler

Model sağlayıcıları

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

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 tam yapılandırma şeması.

Groq Console

Groq kontrol paneli, API belgeleri ve fiyatlandırma.

Overview

Concepts and configuration

Providers

Plugin’i yükleme

Başlarken

Yapılandırma dosyası örneği

Yerleşik katalog

Akıl yürütme modelleri

Ses transkripsiyonu

İlgili içerikler

Model sağlayıcıları

Düşünme modları

Yapılandırma başvurusu

Groq Console

​Plugin’i yükleme

​Başlarken

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

​Yerleşik katalog

​Akıl yürütme modelleri

​Ses transkripsiyonu

​İlgili içerikler

Model sağlayıcıları

Düşünme modları

Yapılandırma başvurusu

Groq Console

Plugin’i yükleme

Başlarken

Yapılandırma dosyası örneği

Yerleşik katalog

Akıl yürütme modelleri

Ses transkripsiyonu

İlgili içerikler