Groq

Groq fournit une inférence ultra-rapide sur des modèles à poids ouverts (Llama, Gemma, Kimi, Qwen, GPT OSS, et bien d’autres) grâce à un matériel LPU personnalisé. OpenClaw inclut un plugin Groq intégré qui enregistre à la fois un fournisseur de chat compatible OpenAI et un fournisseur de compréhension de médias audio.

Propriété	Valeur
ID du fournisseur	`groq`
Plugin	intégré, `enabledByDefault: true`
Variable d’environnement d’authentification	`GROQ_API_KEY`
Indicateur d’intégration	`--auth-choice groq-api-key`
API	Compatible OpenAI (`openai-completions`)
URL de base	`https://api.groq.com/openai/v1`
Transcription audio	`whisper-large-v3-turbo` (par défaut)
Conversation par défaut suggérée	`groq/llama-3.3-70b-versatile`

Getting started

Obtenir une clé API
Créez une clé API sur console.groq.com/keys.

Définir la clé API

openclaw onboard --auth-choice groq-api-key

export GROQ_API_KEY=gsk_...

Set a default model

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

Verify the catalog is reachable
Fenêtre de terminal
```
openclaw models list --provider groq
```

Exemple de fichier de configuration

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

Catalogue intégré

OpenClaw fournit un catalogue Groq basé sur un manifeste, contenant des entrées avec et sans raisonnement. Exécutez openclaw models list --provider groq pour voir les lignes incluses dans votre version installée, ou consultez console.groq.com/docs/models pour la liste officielle de Groq.

Réf modèle	Nom	Raisonnement	Entrée	Contexte
`groq/llama-3.3-70b-versatile`	Llama 3.3 70B Versatile	non	texte	131 072
`groq/llama-3.1-8b-instant`	Llama 3.1 8B Instant	non	texte	131 072
`groq/meta-llama/llama-4-maverick-17b-128e-instruct`	Llama 4 Maverick 17B	non	texte + image	131 072
`groq/meta-llama/llama-4-scout-17b-16e-instruct`	Llama 4 Scout 17B	non	texte + image	131 072
`groq/llama3-70b-8192`	Llama 3 70B	non	texte	8 192
`groq/llama3-8b-8192`	Llama 3 8B	non	texte	8 192
`groq/gemma2-9b-it`	Gemma 2 9B	non	texte	8 192
`groq/mistral-saba-24b`	Mistral Saba 24B	non	texte	32 768
`groq/moonshotai/kimi-k2-instruct`	Kimi K2 Instruct	non	texte	131 072
`groq/moonshotai/kimi-k2-instruct-0905`	Kimi K2 Instruct 0905	non	texte	262 144
`groq/openai/gpt-oss-120b`	GPT OSS 120B	oui	texte	131 072
`groq/openai/gpt-oss-20b`	GPT OSS 20B	oui	texte	131 072
`groq/openai/gpt-oss-safeguard-20b`	Safety GPT OSS 20B	oui	texte	131 072
`groq/qwen-qwq-32b`	Qwen QwQ 32B	oui	texte	131 072
`groq/qwen/qwen3-32b`	Qwen3 32B	oui	texte	131 072
`groq/deepseek-r1-distill-llama-70b`	DeepSeek R1 Distill Llama 70B	oui	texte	131 072
`groq/groq/compound`	Compound	oui	texte	131 072
`groq/groq/compound-mini`	Compound Mini	oui	texte	131 072

Modèles de raisonnement

OpenClaw mappe ses niveaux partagés /think aux valeurs reasoning_effort spécifiques aux modèles de Groq :

Pour qwen/qwen3-32b, la réflexion désactivée envoie none et la réflexion activée envoie default.
Pour les modèles de raisonnement Groq GPT OSS (openai/gpt-oss-*), OpenClaw envoie low, medium ou high en fonction du niveau /think. La réflexion désactivée omet reasoning_effort car ces modèles ne prennent pas en charge une valeur désactivée.
DeepSeek R1 Distill, Qwen QwQ et Compound utilisent la surface de raisonnement native de Groq ; /think contrôle la visibilité mais le modèle raisonne toujours.

Voir Modes de pensée pour les niveaux partagés de /think et comment OpenClaw les traduit pour chaque fournisseur.

Transcription audio

Le plugin inclus de Groq enregistre également un fournisseur de compréhension média audio afin que les messages vocaux puissent être transcrits via l’interface partagée tools.media.audio.

Propriété	Valeur
Chemin de configuration partagé	`tools.media.audio`
URL de base par défaut	`https://api.groq.com/openai/v1`
Modèle par défaut	`whisper-large-v3-turbo`
Priorité automatique	20
Point de terminaison API	`/audio/transcriptions` compatible OpenAI

Pour faire de Groq le backend audio par défaut :

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

Disponibilité de l'environnement pour le démon

Si le Gateway s’exécute en tant que service géré (launchd, systemd, Docker), GROQ_API_KEY doit être visible pour ce processus — et pas seulement pour votre shell interactif.

Custom Groq model ids

OpenClaw accepte n’importe quel identifiant de modèle Groq lors de l’exécution. Utilisez l’identifiant exact affiché par Groq et préfixez-le avec groq/. Le catalogue inclus couvre les cas courants ; les identifiants non catalogués passent par le modèle compatible OpenAI par défaut.

{
  agents: {
    defaults: {
      model: { primary: "groq/

” }, }, }, } ```

Connexes

Fournisseurs de modèles

Choisir les fournisseurs, les références de modèles et le comportement de basculement.

Modes de réflexion

Niveaux d’effort de raisonnement et interaction avec la politique du fournisseur.

Référence de configuration

Schéma de configuration complet incluant les paramètres du provider et de l’audio.

Console Groq

Tableau de bord Groq, documentation de l’API et tarifs.