Fournisseurs de modèles

Référence pour les fournisseurs de LLM/modèles (et non les canaux de discussion comme WhatsApp/Telegram). Pour les règles de sélection des modèles, consultez Modèles.

Règles essentielles

Comportement des fournisseurs géré par les Plugins

La plupart des mécanismes propres aux fournisseurs résident dans les Plugins de fournisseur (registerProvider(...)), tandis qu’OpenClaw conserve la boucle d’inférence générique. Les Plugins gèrent l’intégration initiale, les catalogues de modèles, le mappage des variables d’environnement d’authentification, la normalisation du transport et de la configuration, le nettoyage des schémas d’outils, la classification des basculements, l’actualisation OAuth, les rapports d’utilisation, les profils de réflexion et de raisonnement, et bien plus encore.

La liste complète des hooks du SDK de fournisseur et des exemples de Plugins intégrés se trouve dans Plugins de fournisseur. Un fournisseur nécessitant un exécuteur de requêtes entièrement personnalisé relève d’une surface d’extension distincte et plus approfondie.

Rotation des clés d’API

Plugins de fournisseur officiels

Les Plugins de fournisseur officiels publient leurs propres entrées de catalogue de modèles. Ces fournisseurs ne nécessitent aucune entrée de modèle dans models.providers ; activez le Plugin du fournisseur, configurez l’authentification et choisissez un modèle. Utilisez models.providers uniquement pour les fournisseurs personnalisés explicites ou les paramètres de requête ciblés, tels que les délais d’expiration.

OpenAI

• Fournisseur : openai
• Authentification : OPENAI_API_KEY
• Rotation facultative : OPENAI_API_KEYS, OPENAI_API_KEY_1, OPENAI_API_KEY_2, ainsi que OPENCLAW_LIVE_OPENAI_KEY (remplacement unique)
• Valeur par défaut d’une nouvelle configuration : openai/gpt-5.6 ; sur l’API directe, l’identifiant sans suffixe correspond à Sol.
• Exemples de modèles : openai/gpt-5.6, openai/gpt-5.6-terra, openai/gpt-5.6-luna, openai/gpt-5.5
• Vérifiez la disponibilité du compte/modèle avec openclaw models list --provider openai si une installation ou une clé d’API particulière se comporte différemment.
• CLI : openclaw onboard --auth-choice openai-api-key
• Le transport par défaut est auto ; OpenClaw transmet le choix du transport au runtime de modèle partagé.
• Remplacez-le pour chaque modèle avec agents.defaults.models["openai/<model>"].params.transport ("sse", "websocket" ou "auto")
• Le traitement prioritaire OpenAI peut être activé avec agents.defaults.models["openai/<model>"].params.serviceTier
• /fast et params.fastMode mappent les requêtes Responses directes openai/* sur service_tier=priority sur api.openai.com
• Utilisez params.serviceTier lorsque vous souhaitez un niveau explicite plutôt que le commutateur partagé /fast
• Les en-têtes d’attribution OpenClaw masqués (originator, version, User-Agent) s’appliquent uniquement au trafic OpenAI natif vers api.openai.com, et non aux proxys génériques compatibles avec OpenAI
• Les routes OpenAI natives conservent également store de Responses, les indications de cache d’invite et la mise en forme des charges utiles de compatibilité du raisonnement OpenAI ; les routes de proxy ne les conservent pas
• openai/gpt-5.3-codex-spark est disponible uniquement via l’OAuth ChatGPT/Codex ; les routes directes avec clé d’API OpenAI et clé d’API Azure le rejettent

{  agents: { defaults: { model: { primary: "openai/gpt-5.6" } } },}

Si l’organisation de l’API ne propose pas GPT-5.6, définissez explicitement openai/gpt-5.5. L’intégration initiale et la réauthentification normales conservent un modèle principal explicite existant ; models auth login --set-default et models set sont les méthodes prévues pour le remplacer intentionnellement.

Anthropic

• Fournisseur : anthropic
• Authentification : ANTHROPIC_API_KEY
• Rotation facultative : ANTHROPIC_API_KEYS, ANTHROPIC_API_KEY_1, ANTHROPIC_API_KEY_2, ainsi que OPENCLAW_LIVE_ANTHROPIC_KEY (remplacement unique)
• Exemple de modèle : anthropic/claude-opus-4-6
• CLI : openclaw onboard --auth-choice apiKey
• Les requêtes publiques directes vers Anthropic prennent en charge le commutateur partagé /fast et params.fastMode, y compris le trafic authentifié par clé d’API et OAuth envoyé à api.anthropic.com ; OpenClaw mappe cela sur service_tier d’Anthropic (auto ou standard_only)
• La configuration Claude CLI recommandée conserve la référence canonique du modèle et sélectionne le backend CLI séparément : anthropic/claude-opus-4-8 avec agentRuntime.id: "claude-cli" limité au modèle. Les références héritées claude-cli/claude-opus-4-7 fonctionnent encore à des fins de compatibilité.

{  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" } } },}

OAuth OpenAI ChatGPT/Codex

• Fournisseur : openai
• Authentification : OAuth (ChatGPT)
• Référence de la nouvelle infrastructure native du serveur d’application Codex : openai/gpt-5.6-sol
• Documentation de l’infrastructure native du serveur d’application Codex : Infrastructure Codex
• Références de modèles héritées : codex/gpt-*
• Limite du Plugin : openai/* charge le Plugin OpenAI ; la stratégie de runtime explicite ou la route effective gérée par le fournisseur détermine si le Plugin natif du serveur d’application Codex est sélectionné.
• CLI : openclaw onboard --auth-choice openai ou openclaw models auth login --provider openai
• Le transport ChatGPT Responses intégré à OpenClaw utilise auto par défaut (WebSocket en priorité, SSE en repli).
• agents.defaults.models["openai/<model>"].params.transport, params.serviceTier et params.fastMode sont des paramètres de requête intégrée définis par l’utilisateur. Ils maintiennent la sélection implicite du runtime sur OpenClaw ; le Codex natif gère le transport et le niveau de service de son serveur d’application.
• Les en-têtes d’attribution OpenClaw masqués (originator, version, User-Agent) sont joints uniquement au trafic Codex natif vers chatgpt.com/backend-api, et non aux proxys génériques compatibles avec OpenAI
• Le commutateur partagé /fast reste disponible comme contrôle du runtime ; il est distinct des paramètres de modèle définis par l’utilisateur.
• Le catalogue Codex natif peut présenter les références exactes openai/gpt-5.6-sol, openai/gpt-5.6-terra et openai/gpt-5.6-luna selon l’accès du compte. Il n’applique pas côté client l’alias gpt-5.6 sans suffixe de l’API directe.
• openai/gpt-5.5 utilise la valeur native contextWindow = 400000 du catalogue Codex et la valeur de runtime par défaut contextTokens = 272000 ; remplacez la limite du runtime avec models.providers.openai.models[].contextTokens
• Connectez-vous avec l’authentification openai et utilisez openai/gpt-5.6-sol pour une nouvelle configuration adossée à un abonnement. Sélectionnez explicitement openai/gpt-5.5 si cet espace de travail Codex ne propose pas GPT-5.6.
• Utilisez la valeur fournisseur/modèle agentRuntime.id: "openclaw" pour maintenir sur le runtime intégré une route qui serait autrement admissible. Lorsque le runtime n’est pas défini ou vaut auto, seule une route officielle HTTPS exacte compatible avec Responses/ChatGPT, sans remplacement de requête défini par l’utilisateur, peut sélectionner Codex implicitement.
• Les références GPT Codex héritées constituent un état hérité, et non une route de fournisseur active. Utilisez les références canoniques openai/* pour les nouvelles configurations d’agent et exécutez openclaw doctor --fix pour migrer les anciennes références de modèles Codex héritées sans mettre à niveau une sélection explicite existante de openai/gpt-5.5.

{  plugins: { entries: { codex: { enabled: true } } },  agents: {    defaults: {      model: { primary: "openai/gpt-5.6-sol" },    },  },}

{  models: {    providers: {      openai: {        models: [{ id: "gpt-5.5", contextTokens: 160000 }],      },    },  },}

Autres options hébergées de type abonnement

OpenCode

• Authentification : OPENCODE_API_KEY (ou OPENCODE_ZEN_API_KEY)
• Fournisseur d’exécution Zen : opencode
• Fournisseur d’exécution Go : opencode-go
• Exemples de modèles : opencode/claude-opus-4-6, opencode-go/kimi-k2.6
• CLI : openclaw onboard --auth-choice opencode-zen ou openclaw onboard --auth-choice opencode-go

{  agents: { defaults: { model: { primary: "opencode/claude-opus-4-6" } } },}

Google Gemini (clé API)

• Fournisseur : google
• Authentification : GEMINI_API_KEY
• Rotation facultative : GEMINI_API_KEYS, GEMINI_API_KEY_1, GEMINI_API_KEY_2, repli sur GOOGLE_API_KEY et OPENCLAW_LIVE_GEMINI_KEY (remplacement unique)
• Exemples de modèles : google/gemini-3.1-pro-preview, google/gemini-3.5-flash
• Compatibilité : l’ancienne configuration OpenClaw utilisant google/gemini-3.1-flash-preview est normalisée en google/gemini-3-flash-preview
• Alias : google/gemini-3.1-pro est accepté et normalisé en identifiant actif de l’API Gemini de Google, google/gemini-3.1-pro-preview
• CLI : openclaw onboard --auth-choice gemini-api-key
• Réflexion : /think adaptive utilise la réflexion dynamique de Google. Gemini 3/3.1 omet un thinkingLevel fixe ; Gemini 2.5 envoie thinkingBudget: -1.
• Les exécutions Gemini directes acceptent également agents.defaults.models["google/<model>"].params.cachedContent (ou l’ancien cached_content) pour transmettre un descripteur cachedContents/... natif du fournisseur ; les correspondances du cache Gemini sont exposées sous forme de cacheRead OpenClaw

Google Vertex et Gemini CLI

• Fournisseurs : google-vertex, google-gemini-cli
• Authentification : Vertex utilise ADC de gcloud ; Gemini CLI utilise son flux OAuth

L’intégration OAuth de Gemini CLI est fournie avec le plugin google inclus.

brew install gemini-cli

npm install -g @google/gemini-cli

openclaw plugins enable google

openclaw models auth login --provider google-gemini-cli --set-default

Gemini CLI utilise stream-json par défaut. OpenClaw lit les messages du flux de l’assistant et normalise stats.cached en cacheRead ; les anciens remplacements --output-format json continuent de lire le texte de la réponse dans response.

Z.AI (GLM)

• Fournisseur : zai
• Authentification : ZAI_API_KEY
• Exemple de modèle : zai/glm-5.2
• CLI : openclaw onboard --auth-choice zai-api-key
  • Les références de modèles utilisent l’identifiant canonique de fournisseur zai/*.
  • zai-api-key détecte automatiquement le point de terminaison Z.AI correspondant ; zai-coding-global, zai-coding-cn, zai-global et zai-cn imposent une interface spécifique

Vercel AI Gateway

• Fournisseur : vercel-ai-gateway
• Authentification : AI_GATEWAY_API_KEY
• Exemples de modèles : vercel-ai-gateway/anthropic/claude-opus-4.6, vercel-ai-gateway/moonshotai/kimi-k2.6
• CLI : openclaw onboard --auth-choice ai-gateway-api-key

Autres plugins de fournisseur inclus

Particularités utiles à connaître

Fournisseurs via models.providers (URL personnalisée/de base)

Utilisez models.providers (ou models.json) pour ajouter des fournisseurs personnalisés ou des proxys compatibles avec OpenAI/Anthropic.

De nombreux plugins de fournisseur intégrés ci-dessous publient déjà un catalogue par défaut. Utilisez des entrées models.providers.<id> explicites uniquement lorsque vous souhaitez remplacer l’URL de base, les en-têtes ou la liste des modèles par défaut.

Les vérifications des capacités des modèles du Gateway lisent également les métadonnées explicites models.providers.<id>.models[]. Si un modèle personnalisé ou de proxy accepte les images, définissez input: ["text", "image"] sur ce modèle afin que WebChat et les chemins de pièces jointes provenant d’un nœud transmettent les images comme entrées natives du modèle plutôt que comme références multimédias textuelles uniquement.

agents.defaults.models["provider/model"] contrôle uniquement la visibilité des modèles, les alias et les métadonnées propres à chaque modèle pour les agents. Il n’enregistre pas à lui seul un nouveau modèle d’exécution. Pour les modèles de fournisseur personnalisés, ajoutez également models.providers.<provider>.models[] avec au minimum l’id correspondant.

Moonshot AI (Kimi)

Installez @openclaw/moonshot-provider avant l’intégration. Ajoutez une entrée models.providers.moonshot explicite uniquement lorsque vous devez remplacer l’URL de base ou les métadonnées du modèle :

• Fournisseur : moonshot
• Authentification : MOONSHOT_API_KEY
• Exemple de modèle : moonshot/kimi-k2.6
• CLI : openclaw onboard --auth-choice moonshot-api-key ou openclaw onboard --auth-choice moonshot-api-key-cn

Identifiants des modèles Kimi K2 :

• moonshot/kimi-k2.6
• moonshot/kimi-k2.7-code
• moonshot/kimi-k2.5
• moonshot/kimi-k2-thinking
• moonshot/kimi-k2-thinking-turbo
• moonshot/kimi-k2-turbo

{  agents: {    defaults: { model: { primary: "moonshot/kimi-k2.6" } },  },  models: {    mode: "merge",    providers: {      moonshot: {        baseUrl: "https://api.moonshot.ai/v1",        apiKey: "${MOONSHOT_API_KEY}",        api: "openai-completions",        models: [{ id: "kimi-k2.6", name: "Kimi K2.6" }],      },    },  },}

Consultez Moonshot AI (Kimi + Kimi Coding) pour obtenir le guide de configuration complet.

Kimi Coding

Kimi Coding utilise le point de terminaison compatible avec Anthropic de Moonshot AI :

• Fournisseur : kimi
• Authentification : KIMI_API_KEY
• Exemple de modèle : kimi/kimi-for-coding

{  env: { KIMI_API_KEY: "sk-..." },  agents: {    defaults: { model: { primary: "kimi/kimi-for-coding" } },  },}

Les anciens identifiants kimi/kimi-code et kimi/k2p5 restent acceptés en tant qu’identifiants de modèle de compatibilité et sont normalisés vers l’identifiant de modèle stable de l’API Kimi.

Volcano Engine (Doubao)

Volcano Engine (火山引擎) donne accès à Doubao et à d’autres modèles en Chine.

• Fournisseur : volcengine (codage : volcengine-plan)
• Authentification : VOLCANO_ENGINE_API_KEY
• Exemple de modèle : volcengine-plan/ark-code-latest
• CLI : openclaw onboard --auth-choice volcengine-api-key

{  agents: {    defaults: { model: { primary: "volcengine-plan/ark-code-latest" } },  },}

L’intégration utilise par défaut l’interface de codage, mais le catalogue général volcengine/* est enregistré simultanément.

Dans les sélecteurs de modèles d’intégration/configuration, le choix d’authentification Volcengine privilégie les lignes volcengine/* et volcengine-plan/*. Si ces modèles ne sont pas encore chargés, OpenClaw se rabat sur le catalogue non filtré au lieu d’afficher un sélecteur vide limité au fournisseur.

BytePlus (international)

BytePlus ARK donne accès aux mêmes modèles que Volcano Engine pour les utilisateurs internationaux.

• Fournisseur : byteplus (codage : byteplus-plan)
• Authentification : BYTEPLUS_API_KEY
• Exemple de modèle : byteplus-plan/ark-code-latest
• CLI : openclaw onboard --auth-choice byteplus-api-key

{  agents: {    defaults: { model: { primary: "byteplus-plan/ark-code-latest" } },  },}

L’intégration utilise par défaut l’interface de codage, mais le catalogue général byteplus/* est enregistré simultanément.

Dans les sélecteurs de modèles d’intégration/configuration, le choix d’authentification BytePlus privilégie les lignes byteplus/* et byteplus-plan/*. Si ces modèles ne sont pas encore chargés, OpenClaw se rabat sur le catalogue non filtré au lieu d’afficher un sélecteur vide limité au fournisseur.

Synthetic

Synthetic fournit des modèles compatibles avec Anthropic via le fournisseur synthetic :

• Fournisseur : synthetic
• Authentification : SYNTHETIC_API_KEY
• Exemple de modèle : synthetic/hf:MiniMaxAI/MiniMax-M2.5
• CLI : openclaw onboard --auth-choice synthetic-api-key

{  agents: {    defaults: { model: { primary: "synthetic/hf:MiniMaxAI/MiniMax-M2.5" } },  },  models: {    mode: "merge",    providers: {      synthetic: {        baseUrl: "https://api.synthetic.new/anthropic",        apiKey: "${SYNTHETIC_API_KEY}",        api: "anthropic-messages",        models: [{ id: "hf:MiniMaxAI/MiniMax-M2.5", name: "MiniMax M2.5" }],      },    },  },}

MiniMax

MiniMax est configuré via models.providers, car il utilise des points de terminaison personnalisés :

• OAuth MiniMax (mondial) : --auth-choice minimax-global-oauth
• OAuth MiniMax (Chine) : --auth-choice minimax-cn-oauth
• Clé API MiniMax (mondial) : --auth-choice minimax-global-api
• Clé API MiniMax (Chine) : --auth-choice minimax-cn-api
• Authentification : MINIMAX_API_KEY pour minimax ; MINIMAX_OAUTH_TOKEN ou MINIMAX_API_KEY pour minimax-portal

Consultez /providers/minimax pour obtenir les détails de configuration, les options de modèles et des extraits de configuration.

Répartition des capacités détenues par le plugin :

• Les valeurs par défaut de texte/conversation restent sur minimax/MiniMax-M3
• La génération d’images utilise minimax/image-01 ou minimax-portal/image-01
• La compréhension d’images utilise le modèle MiniMax-VL-01 détenu par le plugin sur les deux chemins d’authentification MiniMax
• La recherche Web reste sur l’identifiant de fournisseur minimax

LM Studio

LM Studio est fourni sous forme de plugin de fournisseur intégré utilisant l’API native :

• Fournisseur : lmstudio
• Authentification : LM_API_TOKEN
• URL de base d’inférence par défaut : http://localhost:1234/v1

Définissez ensuite un modèle (remplacez-le par l’un des identifiants renvoyés par http://localhost:1234/api/v1/models) :

{  agents: {    defaults: { model: { primary: "lmstudio/openai/gpt-oss-20b" } },  },}

OpenClaw utilise les points de terminaison natifs /api/v1/models et /api/v1/models/load de LM Studio pour la découverte et le chargement automatique, avec /v1/chat/completions pour l’inférence par défaut. Si vous souhaitez que le chargement JIT, la durée de vie et l’éviction automatique de LM Studio gèrent le cycle de vie du modèle, définissez models.providers.lmstudio.params.preload: false. Consultez /providers/lmstudio pour la configuration et le dépannage.

Ollama

Ollama est fourni sous forme de plugin de fournisseur intégré et utilise l’API native d’Ollama :

• Fournisseur : ollama
• Authentification : aucune requise (serveur local)
• Exemple de modèle : ollama/llama3.3
• Installation : https://ollama.com/download

# Installez Ollama, puis téléchargez un modèle :ollama pull llama3.3

{  agents: {    defaults: { model: { primary: "ollama/llama3.3" } },  },}

Ollama est détecté localement à l’adresse http://127.0.0.1:11434 lorsque vous l’activez avec OLLAMA_API_KEY, et le plugin de fournisseur intégré ajoute directement Ollama à openclaw onboard et au sélecteur de modèles. Consultez /providers/ollama pour l’intégration, le mode cloud/local et la configuration personnalisée.

vLLM

vLLM est fourni sous forme de plugin de fournisseur intégré pour les serveurs locaux/auto-hébergés compatibles avec OpenAI :

• Fournisseur : vllm
• Authentification : facultative (selon votre serveur)
• URL de base par défaut : http://127.0.0.1:8000/v1

Pour activer la découverte automatique locale (n’importe quelle valeur convient si votre serveur n’impose pas d’authentification) :

export VLLM_API_KEY="vllm-local"

Définissez ensuite un modèle (remplacez-le par l’un des identifiants renvoyés par /v1/models) :

{  agents: {    defaults: { model: { primary: "vllm/your-model-id" } },  },}

Consultez /providers/vllm pour plus de détails.

SGLang

SGLang est fourni sous forme de plugin de fournisseur intégré pour les serveurs rapides auto-hébergés compatibles avec OpenAI :

• Fournisseur : sglang
• Authentification : facultative (selon votre serveur)
• URL de base par défaut : http://127.0.0.1:30000/v1

Pour activer la découverte automatique locale (n’importe quelle valeur convient si votre serveur n’impose pas d’authentification) :

export SGLANG_API_KEY="sglang-local"

Définissez ensuite un modèle (remplacez-le par l’un des identifiants renvoyés par /v1/models) :

{  agents: {    defaults: { model: { primary: "sglang/your-model-id" } },  },}

Consultez /providers/sglang pour plus de détails.

Proxys locaux (LM Studio, vLLM, LiteLLM, etc.)

Exemple (compatible avec OpenAI) :

{  agents: {    defaults: {      model: { primary: "lmstudio/my-local-model" },      models: { "lmstudio/my-local-model": { alias: "Local" } },    },  },  models: {    providers: {      lmstudio: {        baseUrl: "http://localhost:1234/v1",        apiKey: "${LM_API_TOKEN}",        api: "openai-completions",        timeoutSeconds: 300,        models: [          {            id: "my-local-model",            name: "Modèle local",            reasoning: false,            input: ["text"],            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },            contextWindow: 200000,            maxTokens: 8192,          },        ],      },    },  },}

Exemples de CLI

openclaw onboard --auth-choice opencode-zenopenclaw models set opencode/claude-opus-4-6openclaw models list

Voir aussi : Configuration pour des exemples de configuration complets.

Ressources connexes

• Référence de configuration - clés de configuration des modèles
• Basculement de modèle - chaînes de repli et comportement de nouvelle tentative
• Modèles - configuration et alias des modèles
• Fournisseurs - guides de configuration propres à chaque fournisseur