> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Groq

[Groq](https://groq.com), ö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.

| Özellik                     | Değer                                 |
| --------------------------- | ------------------------------------- |
| Sağlayıcı kimliği           | `groq`                                |
| Plugin                      | resmi harici paket                    |
| Kimlik doğrulama env var    | `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 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:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw plugins install @openclaw/groq-provider
openclaw gateway restart
```

## Başlarken

<Steps>
  <Step title="API anahtarı alma">
    [console.groq.com/keys](https://console.groq.com/keys) adresinde bir API anahtarı oluşturun.
  </Step>

  <Step title="API anahtarını ayarlama">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    export GROQ_API_KEY=gsk_...
    ```
  </Step>

  <Step title="Varsayılan model ayarlama">
    ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
    {
      agents: {
        defaults: {
          model: { primary: "groq/llama-3.3-70b-versatile" },
        },
      },
    }
    ```
  </Step>

  <Step title="Kataloğun erişilebilir olduğunu doğrulama">
    ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
    openclaw models list --provider groq
    ```
  </Step>
</Steps>

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

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  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](https://console.groq.com/docs/models) sayfasına bakın.

| Model ref                                        | 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 |

<Tip>
  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](https://console.groq.com/docs/models) ile karşılaştırarak kontrol edin.
</Tip>

## 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ı](/tr/tools/thinking) 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.

| Ö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’u varsayılan ses arka ucu yapmak için:

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  tools: {
    media: {
      audio: {
        models: [{ provider: "groq" }],
      },
    },
  },
}
```

<AccordionGroup>
  <Accordion title="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ğunuzda değil, o süreç tarafından da görülebilir olmalıdır.

    <Warning>
      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.
    </Warning>
  </Accordion>

  <Accordion title="Ö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 olmayan kimlikler varsayılan OpenAI uyumlu şablona düşer.

    ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
    {
      agents: {
        defaults: {
          model: { primary: "groq/<your-model-id>" },
        },
      },
    }
    ```
  </Accordion>
</AccordionGroup>

## İlgili

<CardGroup cols={2}>
  <Card title="Model sağlayıcıları" href="/tr/concepts/model-providers" icon="layers">
    Sağlayıcıları, model ref’lerini ve failover davranışını seçme.
  </Card>

  <Card title="Düşünme modları" href="/tr/tools/thinking" icon="brain">
    Akıl yürütme çabası düzeyleri ve sağlayıcı-politika etkileşimi.
  </Card>

  <Card title="Yapılandırma referansı" href="/tr/gateway/configuration-reference" icon="gear">
    Sağlayıcı ve ses ayarları dahil tam yapılandırma şeması.
  </Card>

  <Card title="Groq Console" href="https://console.groq.com" icon="arrow-up-right-from-square">
    Groq panosu, API dokümanları ve fiyatlandırma.
  </Card>
</CardGroup>