Passer au contenu principal
Groq fournit une inférence ultra-rapide sur des modèles à poids ouverts (Llama, Gemma, Kimi, Qwen, GPT OSS, et plus encore) à l’aide de matériel LPU personnalisé. Le plugin Groq enregistre à la fois un fournisseur de chat compatible OpenAI et un fournisseur de compréhension multimédia audio.
PropriétéValeur
ID du fournisseurgroq
Pluginpackage externe officiel
Variable d’env. d’authGROQ_API_KEY
APIcompatible OpenAI (openai-completions)
URL de basehttps://api.groq.com/openai/v1
Transcription audiowhisper-large-v3-turbo (par défaut)
Chat par défaut suggérégroq/llama-3.3-70b-versatile

​
Installer le plugin

Installez le plugin officiel, puis redémarrez Gateway : 
openclaw plugins install @openclaw/groq-provider
openclaw gateway restart

​
Premiers pas

1

Obtenir une clé API

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

Définir la clé API

export GROQ_API_KEY=gsk_...
3

Définir un modèle par défaut

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

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 fournit un catalogue Groq adossé à un manifeste, avec des entrées de raisonnement et sans raisonnement. Exécutez openclaw models list --provider groq pour afficher les lignes statiques de votre version installée, ou consultez console.groq.com/docs/models pour la liste de référence de Groq.
Réf. du modèleNomRaisonnementEntréeContexte
groq/llama-3.3-70b-versatileLlama 3.3 70B Versatilenontexte131,072
groq/llama-3.1-8b-instantLlama 3.1 8B Instantnontexte131,072
groq/meta-llama/llama-4-scout-17b-16e-instructLlama 4 Scout 17Bnontexte + image131,072
groq/openai/gpt-oss-120bGPT OSS 120Bouitexte131,072
groq/openai/gpt-oss-20bGPT OSS 20Bouitexte131,072
groq/openai/gpt-oss-safeguard-20bSafety GPT OSS 20Bouitexte131,072
groq/qwen/qwen3-32bQwen3 32Bouitexte131,072
groq/groq/compoundCompoundouitexte131,072
groq/groq/compound-miniCompound Miniouitexte131,072
Le catalogue évolue avec chaque version d’OpenClaw. openclaw models list --provider groq affiche les lignes connues de votre version installée ; vérifiez avec console.groq.com/docs/models pour les modèles nouvellement ajoutés ou dépréciés.

​
Modèles de raisonnement

OpenClaw associe ses niveaux /think partagés aux valeurs reasoning_effort propres aux modèles 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 selon le niveau /think. La réflexion désactivée omet reasoning_effort, car ces modèles ne prennent pas en charge de 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.
Consultez Modes de réflexion pour les niveaux /think partagés et la manière dont OpenClaw les traduit par fournisseur.

​
Transcription audio

Le plugin de Groq enregistre aussi un fournisseur de compréhension multimédia audio afin que les messages vocaux puissent être transcrits via la surface partagée tools.media.audio.
PropriétéValeur
Chemin de configuration partagétools.media.audio
URL de base par défauthttps://api.groq.com/openai/v1
Modèle par défautwhisper-large-v3-turbo
Priorité automatique20
Point de terminaison API/audio/transcriptions compatible OpenAI
Pour faire de Groq le backend audio par défaut : 
{
  tools: {
    media: {
      audio: {
        models: [{ provider: "groq" }],
      },
    },
  },
}
Si Gateway s’exécute comme service géré (launchd, systemd, Docker), GROQ_API_KEY doit être visible par ce processus, pas seulement par votre shell interactif.
Une clé exportée uniquement dans un shell interactif n’aidera pas 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 pour la rendre lisible par le processus Gateway.
OpenClaw accepte tout ID de modèle Groq à l’exécution. Utilisez l’ID exact affiché par Groq et préfixez-le avec groq/. Le catalogue statique couvre les cas courants ; les IDs absents du catalogue utilisent le modèle compatible OpenAI par défaut.
{
  agents: {
    defaults: {
      model: { primary: "groq/<your-model-id>" },
    },
  },
}

​
Connexe

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 des fournisseurs.

Référence de configuration

Schéma de configuration complet, y compris les paramètres de fournisseur et audio.

Console Groq

Tableau de bord Groq, documentation API et tarification.