Langsung ke konten utama
Groq menyediakan inferensi sangat cepat pada model berbobot terbuka (Llama, Gemma, Kimi, Qwen, GPT OSS, dan lainnya) menggunakan perangkat keras LPU khusus. Plugin Groq mendaftarkan penyedia chat yang kompatibel dengan OpenAI dan penyedia pemahaman media audio.
PropertiNilai
Id penyediagroq
Pluginpaket eksternal resmi
Variabel env authGROQ_API_KEY
APIKompatibel OpenAI (openai-completions)
URL dasarhttps://api.groq.com/openai/v1
Transkripsi audiowhisper-large-v3-turbo (bawaan)
Bawaan chat disarankangroq/llama-3.3-70b-versatile

​
Instal Plugin

Instal Plugin resmi, lalu mulai ulang Gateway: 
openclaw plugins install @openclaw/groq-provider
openclaw gateway restart

​
Memulai

1

Get an API key

Buat kunci API di console.groq.com/keys.
2

Set the API key

export GROQ_API_KEY=gsk_...
3

Set a default model

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

Verify the catalog is reachable

openclaw models list --provider groq

​
Contoh file konfigurasi

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

​
Katalog bawaan

OpenClaw menyertakan katalog Groq berbasis manifes dengan entri penalaran dan non-penalaran. Jalankan openclaw models list --provider groq untuk melihat baris statis bagi versi terinstal Anda, atau periksa console.groq.com/docs/models untuk daftar resmi Groq.
Ref modelNamaPenalaranMasukanKonteks
groq/llama-3.3-70b-versatileLlama 3.3 70B Versatiletidakteks131,072
groq/llama-3.1-8b-instantLlama 3.1 8B Instanttidakteks131,072
groq/meta-llama/llama-4-scout-17b-16e-instructLlama 4 Scout 17Btidakteks + gambar131,072
groq/openai/gpt-oss-120bGPT OSS 120Byateks131,072
groq/openai/gpt-oss-20bGPT OSS 20Byateks131,072
groq/openai/gpt-oss-safeguard-20bSafety GPT OSS 20Byateks131,072
groq/qwen/qwen3-32bQwen3 32Byateks131,072
groq/groq/compoundCompoundyateks131,072
groq/groq/compound-miniCompound Miniyateks131,072
Katalog berkembang di setiap rilis OpenClaw. openclaw models list --provider groq menampilkan baris yang diketahui versi terinstal Anda; cocokkan dengan console.groq.com/docs/models untuk model yang baru ditambahkan atau tidak digunakan lagi.

​
Model penalaran

OpenClaw memetakan level /think bersama ke nilai reasoning_effort khusus model milik Groq:
  • Untuk qwen/qwen3-32b, pemikiran yang dinonaktifkan mengirim none dan pemikiran yang diaktifkan mengirim default.
  • Untuk model penalaran Groq GPT OSS (openai/gpt-oss-*), OpenClaw mengirim low, medium, atau high berdasarkan level /think. Pemikiran yang dinonaktifkan menghilangkan reasoning_effort karena model tersebut tidak mendukung nilai nonaktif.
  • DeepSeek R1 Distill, Qwen QwQ, dan Compound menggunakan permukaan penalaran native Groq; /think mengontrol visibilitas tetapi model selalu bernalar.
Lihat Mode berpikir untuk level /think bersama dan cara OpenClaw menerjemahkannya per penyedia.

​
Transkripsi audio

Plugin Groq juga mendaftarkan penyedia pemahaman media audio sehingga pesan suara dapat ditranskripsikan melalui permukaan bersama tools.media.audio.
PropertiNilai
Jalur konfigurasi bersamatools.media.audio
URL dasar bawaanhttps://api.groq.com/openai/v1
Model bawaanwhisper-large-v3-turbo
Prioritas otomatis20
Endpoint APIKompatibel OpenAI /audio/transcriptions
Untuk menjadikan Groq backend audio bawaan: 
{
  tools: {
    media: {
      audio: {
        models: [{ provider: "groq" }],
      },
    },
  },
}
Jika Gateway berjalan sebagai layanan terkelola (launchd, systemd, Docker), GROQ_API_KEY harus terlihat oleh proses tersebut, bukan hanya oleh shell interaktif Anda.
Kunci yang diekspor hanya di shell interaktif tidak akan membantu daemon launchd atau systemd kecuali lingkungan tersebut juga diimpor ke sana. Atur kunci di ~/.openclaw/.env atau melalui env.shellEnv agar dapat dibaca dari proses gateway.
OpenClaw menerima id model Groq apa pun saat runtime. Gunakan id persis yang ditampilkan oleh Groq dan beri prefiks groq/. Katalog statis mencakup kasus umum; id yang tidak ada di katalog akan diteruskan ke templat bawaan yang kompatibel dengan OpenAI.
{
  agents: {
    defaults: {
      model: { primary: "groq/<your-model-id>" },
    },
  },
}

​
Terkait

Model providers

Memilih penyedia, ref model, dan perilaku failover.

Thinking modes

Level upaya penalaran dan interaksi kebijakan penyedia.

Configuration reference

Skema konfigurasi lengkap termasuk pengaturan penyedia dan audio.

Groq Console

Dasbor Groq, dokumentasi API, dan harga.