Groq

Groq menyediakan inferensi berkecepatan sangat tinggi pada model berbobot terbuka (Llama, Gemma, Kimi, Qwen, GPT OSS, dan lainnya) menggunakan perangkat keras LPU khusus. Plugin Groq mendaftarkan penyedia percakapan yang kompatibel dengan OpenAI sekaligus penyedia pemahaman media audio.

Properti	Nilai
ID penyedia	`groq`
Plugin	paket eksternal resmi
Variabel lingkungan autentikasi	`GROQ_API_KEY`
API	Kompatibel dengan OpenAI (`openai-completions`)
URL dasar	`https://api.groq.com/openai/v1`
Transkripsi audio	`whisper-large-v3-turbo` (bawaan)
Bawaan percakapan yang disarankan	`groq/llama-3.3-70b-versatile`

Instal Plugin

Instal Plugin resmi, lalu mulai ulang Gateway:

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

Memulai

Dapatkan kunci API

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

Tetapkan kunci API

export GROQ_API_KEY=gsk_...

Tetapkan model bawaan

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

Verifikasi katalog dapat diakses

openclaw models list --provider groq

Contoh berkas 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 nonpenalaran. Jalankan openclaw models list --provider groq untuk melihat baris statis bagi versi yang Anda instal, atau periksa console.groq.com/docs/models untuk daftar resmi dari Groq.

Referensi model	Nama	Penalaran	Masukan	Konteks
`groq/llama-3.3-70b-versatile`	Llama 3.3 70B Versatile	tidak	teks	131,072
`groq/llama-3.1-8b-instant`	Llama 3.1 8B Instant	tidak	teks	131,072
`groq/meta-llama/llama-4-scout-17b-16e-instruct`	Llama 4 Scout 17B	tidak	teks + gambar	131,072
`groq/openai/gpt-oss-120b`	GPT OSS 120B	ya	teks	131,072
`groq/openai/gpt-oss-20b`	GPT OSS 20B	ya	teks	131,072
`groq/openai/gpt-oss-safeguard-20b`	GPT OSS Keamanan 20B	ya	teks	131,072
`groq/qwen/qwen3-32b`	Qwen3 32B	ya	teks	131,072
`groq/groq/compound`	Compound	ya	teks	131,072
`groq/groq/compound-mini`	Compound Mini	ya	teks	131,072

Katalog berkembang pada setiap rilis OpenClaw. openclaw models list --provider groq menampilkan baris yang dikenali oleh versi yang Anda instal; bandingkan dengan console.groq.com/docs/models untuk model yang baru ditambahkan atau tidak lagi direkomendasikan.

Model penalaran

Model penalaran Groq (reasoning: true dalam tabel di atas) memetakan tingkat /think bersama milik OpenClaw ke nilai reasoning_effort berupa low, medium, atau high. /think off atau /think none menghilangkan reasoning_effort dari permintaan, alih-alih mengirimkan nilai yang dinonaktifkan. Lihat Mode berpikir untuk tingkat /think bersama dan cara OpenClaw menerjemahkannya untuk setiap penyedia.

Transkripsi audio

Plugin Groq juga mendaftarkan penyedia pemahaman media audio agar pesan suara dapat ditranskripsikan melalui antarmuka bersama tools.media.audio.

Properti	Nilai
Jalur konfigurasi bersama	`tools.media.audio`
URL dasar bawaan	`https://api.groq.com/openai/v1`
Model bawaan	`whisper-large-v3-turbo`
Prioritas otomatis	20
Titik akhir API	`/audio/transcriptions` yang kompatibel dengan OpenAI

Untuk menjadikan Groq sebagai backend audio bawaan:

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

Ketersediaan lingkungan untuk daemon

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 hanya diekspor dalam shell interaktif tidak akan tersedia bagi daemon launchd atau systemd, kecuali lingkungan tersebut juga diimpor ke sana. Tetapkan kunci di ~/.openclaw/.env atau melalui env.shellEnv agar dapat dibaca oleh proses Gateway.

ID model Groq khusus

OpenClaw menerima ID model Groq apa pun saat runtime. Gunakan ID persis seperti yang ditampilkan oleh Groq dan tambahkan prefiks groq/. Katalog statis mencakup kasus umum; ID yang tidak tercantum dalam katalog akan menggunakan templat bawaan yang kompatibel dengan OpenAI.

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

Terkait

Penyedia model

Memilih penyedia, referensi model, dan perilaku pengalihan kegagalan.

Mode berpikir

Tingkat upaya penalaran dan interaksi kebijakan penyedia.

Referensi konfigurasi

Skema konfigurasi lengkap termasuk pengaturan penyedia dan audio.

Konsol Groq

Dasbor Groq, dokumentasi API, dan harga.

Overview

Concepts and configuration

Providers

Instal Plugin

Memulai

Contoh berkas konfigurasi

Katalog bawaan

Model penalaran

Transkripsi audio

Terkait

Penyedia model

Mode berpikir

Referensi konfigurasi

Konsol Groq

​Instal Plugin

​Memulai

​Contoh berkas konfigurasi

​Katalog bawaan

​Model penalaran

​Transkripsi audio

​Terkait

Penyedia model

Mode berpikir

Referensi konfigurasi

Konsol Groq

Instal Plugin

Memulai

Contoh berkas konfigurasi

Katalog bawaan

Model penalaran

Transkripsi audio

Terkait