Groq

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

Propriété	Valeur
Identifiant du fournisseur	`groq`
Plugin	paquet externe officiel
Variable d’environnement d’authentification	`GROQ_API_KEY`
API	compatible avec OpenAI (`openai-completions`)
URL de base	`https://api.groq.com/openai/v1`
Transcription audio	`whisper-large-v3-turbo` (par défaut)
Modèle de chat par défaut suggéré	`groq/llama-3.3-70b-versatile`

Installer le plugin

Installez le plugin officiel, puis redémarrez le Gateway :

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

Bien démarrer

Obtenir une clé API

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

Définir la clé API

export GROQ_API_KEY=gsk_...

Définir un modèle par défaut

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

Vérifier que le catalogue est accessible

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 inclut un catalogue Groq basé sur un manifeste, comprenant des entrées avec et sans raisonnement. Exécutez openclaw models list --provider groq pour afficher les lignes statiques correspondant à votre version installée, ou consultez console.groq.com/docs/models pour obtenir la liste de référence de Groq.

Référence du 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-scout-17b-16e-instruct`	Llama 4 Scout 17B	non	texte + image	131,072
`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/qwen3-32b`	Qwen3 32B	oui	texte	131,072
`groq/groq/compound`	Compound	oui	texte	131,072
`groq/groq/compound-mini`	Compound Mini	oui	texte	131,072

Le catalogue évolue à chaque version d’OpenClaw. openclaw models list --provider groq affiche les lignes connues de votre version installée ; comparez-les avec console.groq.com/docs/models pour connaître les modèles récemment ajoutés ou obsolètes.

Modèles de raisonnement

Les modèles de raisonnement Groq (reasoning: true dans le tableau ci-dessus) associent les niveaux /think communs d’OpenClaw aux valeurs reasoning_effort low, medium ou high. /think off ou /think none omet reasoning_effort de la requête au lieu d’envoyer une valeur désactivée. Consultez Modes de réflexion pour découvrir les niveaux /think communs et la façon dont OpenClaw les traduit pour chaque fournisseur.

Transcription audio

Le plugin Groq enregistre également un fournisseur de compréhension de médias audio, afin que les messages vocaux puissent être transcrits par l’intermédiaire de 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 de l’API	`/audio/transcriptions` compatible avec OpenAI

Pour utiliser Groq comme moteur 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 par ce processus, et pas uniquement par votre shell interactif.

Une clé exportée uniquement dans un shell interactif ne sera pas accessible à un démon launchd ou systemd, sauf si cet environnement y est également importé. Définissez la clé dans ~/.openclaw/.env ou via env.shellEnv afin qu’elle soit lisible par le processus du Gateway.

Identifiants de modèles Groq personnalisés

OpenClaw accepte n’importe quel identifiant de modèle Groq lors de l’exécution. Utilisez l’identifiant exact indiqué par Groq et ajoutez-lui le préfixe groq/. Le catalogue statique couvre les cas courants ; les identifiants absents du catalogue utilisent le modèle compatible avec OpenAI par défaut.

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

Pages associées

Fournisseurs de modèles

Choix des fournisseurs, des références de modèles et du 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, notamment les paramètres des fournisseurs et de l’audio.

Console Groq

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

Overview

Concepts and configuration

Providers

Installer le plugin

Bien démarrer

Exemple de fichier de configuration

Catalogue intégré

Modèles de raisonnement

Transcription audio

Pages associées

Fournisseurs de modèles

Modes de réflexion

Référence de configuration

Console Groq

​Installer le plugin

​Bien démarrer

​Exemple de fichier de configuration

​Catalogue intégré

​Modèles de raisonnement

​Transcription audio

​Pages associées

Fournisseurs de modèles

Modes de réflexion

Référence de configuration

Console Groq

Installer le plugin

Bien démarrer

Exemple de fichier de configuration

Catalogue intégré

Modèles de raisonnement

Transcription audio

Pages associées