OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

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 :

bash
openclaw plugins install @openclaw/groq-provideropenclaw gateway restart

Bien démarrer

  • Obtenir une clé API

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

  • Définir la clé API

    bash
    export GROQ_API_KEY=gsk_...

  • Définir un modèle par défaut

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

  • Vérifier que le catalogue est accessible

    bash
    openclaw models list --provider groq

    • Exemple de fichier de configuration

    json5
    {  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

    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 :

    json5
    {  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.

    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.

    json5
    {  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.
    Was this useful?
    On this page

    On this page