Ana içeriğe atla
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, hem OpenAI uyumlu bir sohbet sağlayıcısı hem de bir ses ortamı-anlama sağlayıcısı kaydeder.
ÖzellikDeğer
Sağlayıcı kimliğigroq
Pluginresmi harici paket
Kimlik doğrulama env varGROQ_API_KEY
APIOpenAI uyumlu (openai-completions)
Temel URLhttps://api.groq.com/openai/v1
Ses transkripsiyonuwhisper-large-v3-turbo (varsayılan)
Önerilen sohbet varsayılanıgroq/llama-3.3-70b-versatile

​
Plugin 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

1

API anahtarı alma

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

API anahtarını ayarlama

export GROQ_API_KEY=gsk_...
3

Varsayılan model ayarlama

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

Kataloğun erişilebilir olduğunu 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üten hem de akıl yürütmeyen girdilere sahip, manifest destekli bir Groq kataloğuyla gelir. Yüklü sürümünüz için statik satırları görmek üzere openclaw models list --provider groq komutunu çalıştırın veya Groq’un yetkili listesi için console.groq.com/docs/models sayfasına bakın.
Model refAdAkıl yürütmeGirdiBağlam
groq/llama-3.3-70b-versatileLlama 3.3 70B Versatilehayırmetin131,072
groq/llama-3.1-8b-instantLlama 3.1 8B Instanthayırmetin131,072
groq/meta-llama/llama-4-scout-17b-16e-instructLlama 4 Scout 17Bhayırmetin + görsel131,072
groq/openai/gpt-oss-120bGPT OSS 120Bevetmetin131,072
groq/openai/gpt-oss-20bGPT OSS 20Bevetmetin131,072
groq/openai/gpt-oss-safeguard-20bSafety GPT OSS 20Bevetmetin131,072
groq/qwen/qwen3-32bQwen3 32Bevetmetin131,072
groq/groq/compoundCompoundevetmetin131,072
groq/groq/compound-miniCompound Minievetmetin131,072
Katalog her OpenClaw sürümüyle 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 ile karşılaştırarak kontrol edin.

​
Akıl yürütme modelleri

OpenClaw, paylaşılan /think düzeylerini Groq’un modele özgü reasoning_effort değerlerine eşler:
  • qwen/qwen3-32b için devre dışı düşünme none, etkin düşünme ise default gönderir.
  • Groq GPT OSS akıl yürütme modelleri (openai/gpt-oss-*) için OpenClaw, /think düzeyine göre low, medium veya high gönderir. Devre dışı düşünme reasoning_effort değerini atlar, çünkü bu modeller devre dışı bir değeri desteklemez.
  • DeepSeek R1 Distill, Qwen QwQ ve Compound, Groq’un yerel akıl yürütme yüzeyini kullanır; /think görünürlüğü denetler, ancak model her zaman akıl yürütür.
Paylaşılan /think düzeyleri ve OpenClaw’ın bunları sağlayıcı başına nasıl çevirdiği için Düşünme modları bölümüne bakın.

​
Ses transkripsiyonu

Groq’un Plugin’i ayrıca sesli mesajların paylaşılan tools.media.audio yüzeyi üzerinden transkribe edilebilmesi için bir ses ortamı-anlama sağlayıcısı kaydeder.
ÖzellikDeğer
Paylaşılan yapılandırma yolutools.media.audio
Varsayılan temel URLhttps://api.groq.com/openai/v1
Varsayılan modelwhisper-large-v3-turbo
Otomatik öncelik20
API uç noktasıOpenAI uyumlu /audio/transcriptions
Groq’u varsayılan ses arka ucu yapmak için: 
{
  tools: {
    media: {
      audio: {
        models: [{ provider: "groq" }],
      },
    },
  },
}
Gateway yönetilen bir hizmet (launchd, systemd, Docker) olarak çalışıyorsa GROQ_API_KEY, yalnızca etkileşimli kabuğunuzda değil, o süreç tarafından da görülebilir olmalıdır.
Yalnızca etkileşimli bir kabukta dışa aktarılan bir anahtar, o ortam oraya da içe aktarılmadıkça launchd veya systemd daemon’una yardımcı olmaz. Anahtarı gateway sürecinden okunabilir yapmak için ~/.openclaw/.env içinde veya env.shellEnv aracılığıyla ayarlayın.
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 olmayan kimlikler varsayılan OpenAI uyumlu şablona düşer.
{
  agents: {
    defaults: {
      model: { primary: "groq/<your-model-id>" },
    },
  },
}

​
İlgili

Model sağlayıcıları

Sağlayıcıları, model ref’lerini ve failover davranışını seçme.

Düşünme modları

Akıl yürütme çabası düzeyleri ve sağlayıcı-politika etkileşimi.

Yapılandırma referansı

Sağlayıcı ve ses ayarları dahil tam yapılandırma şeması.

Groq Console

Groq panosu, API dokümanları ve fiyatlandırma.