CLI des modèles

​

Ordre de sélection

• agents.defaults.models est la liste d’autorisation/le catalogue des modèles qu’OpenClaw peut utiliser, ainsi que leurs alias. Utilisez des entrées provider/* pour autoriser tous les modèles découverts auprès d’un fournisseur sans les répertorier individuellement.
• agents.defaults.utilityModel est un modèle facultatif moins coûteux destiné aux courtes tâches internes, telles que les titres générés des sessions du tableau de bord, les titres des fils de discussion/sujets des canaux pris en charge et la narration de la progression. La valeur agents.list[].utilityModel propre à chaque agent la remplace. Lorsqu’elle n’est pas définie, OpenClaw utilise le petit modèle par défaut déclaré par le fournisseur principal lorsqu’il en existe un (OpenAI → gpt-5.6-luna, Anthropic → claude-haiku-4-5), sinon le modèle principal de l’agent ; définissez-la sur une chaîne vide pour désactiver le routage des tâches utilitaires. Les tâches utilitaires sont des appels de modèle distincts et peuvent envoyer un contenu de tâche limité au fournisseur du modèle sélectionné.
• agents.defaults.imageModel est utilisé uniquement lorsque le modèle principal ne peut pas accepter d’images.
• agents.defaults.pdfModel est utilisé par l’outil pdf. S’il n’est pas défini, l’outil utilise en secours imageModel, puis le modèle résolu de la session/par défaut.
• agents.defaults.imageGenerationModel, musicGenerationModel et videoGenerationModel prennent en charge les outils partagés de génération de médias. Si elles ne sont pas définies, chaque outil déduit un fournisseur par défaut disposant d’une authentification : d’abord le fournisseur actuellement défini par défaut, puis les autres fournisseurs enregistrés pour cette fonctionnalité, dans l’ordre de leur identifiant. Définissez agents.defaults.mediaGenerationAutoProviderFallback: false pour désactiver cette déduction entre fournisseurs tout en conservant les modèles de secours explicites.
• La valeur agents.list[].model propre à chaque agent (ainsi que les liaisons) remplace agents.defaults.model — consultez Routage multi-agent.

​

Source de sélection et rigueur du basculement

• La modification de agents.defaults.model.primary ne réécrit pas les modèles épinglés des sessions existantes. Si l’état indique This session is pinned to X; config primary Y will apply to new/unpinned sessions., exécutez /model default pour supprimer l’épinglage.
• Les sélecteurs de modèle par défaut et de liste d’autorisation de la CLI respectent models.mode: "replace" en répertoriant uniquement models.providers.*.models au lieu de l’intégralité du catalogue intégré.
• Le sélecteur de modèle de l’interface de contrôle demande au Gateway sa vue configurée des modèles : agents.defaults.models lorsqu’elle est définie (y compris les entrées génériques provider/*), sinon models.providers.*.models ainsi que les fournisseurs disposant d’une authentification utilisable. L’intégralité du catalogue intégré est réservée aux vues de navigation explicites (models.list avec view: "all", ou openclaw models list --all).
• Les interfaces d’inventaire des fournisseurs utilisent models.list avec view: "provider-config" pour afficher les lignes de models.providers.*.models définies par la source sans appliquer les listes d’autorisation des sélecteurs.

​

Politique rapide pour les modèles

• Définissez comme modèle principal le modèle de dernière génération le plus performant auquel vous avez accès.
• Utilisez des modèles de secours pour les tâches sensibles au coût ou à la latence et les conversations à moindre enjeu.
• Pour les agents dotés d’outils ou les entrées non fiables, évitez les niveaux de modèles anciens ou moins performants.

​

Intégration initiale

openclaw onboard

​

« Modèle non autorisé » (et pourquoi les réponses s’arrêtent)

Le modèle "provider/model" n’est pas autorisé. Utilisez /models pour répertorier les fournisseurs, ou /models <provider> pour répertorier les modèles.
Ajoutez-le avec : openclaw config set agents.defaults.models '{"provider/model":{}}' --strict-json --merge

{
  agents: {
    defaults: {
      models: {
        "openai/*": {},
        "vllm/*": {},
      },
    },
  },
}

{
  agents: {
    defaults: {
      model: { primary: "anthropic/claude-sonnet-4-6" },
      models: {
        "anthropic/claude-sonnet-4-6": { alias: "Sonnet" },
        "anthropic/claude-opus-4-6": { alias: "Opus" },
      },
    },
  },
}

openclaw config set agents.defaults.models '{"openai/gpt-5.4":{}}' --strict-json --merge

​

/model dans la conversation

/model
/model list
/model 3
/model openai/gpt-5.4
/model default
/model status

• /model et /model list affichent un sélecteur numéroté compact (famille de modèles + fournisseurs disponibles) ; /model <#> permet d’y effectuer une sélection. Sur Discord, cela ouvre des listes déroulantes de fournisseurs et de modèles avec une étape Submit ; sur Telegram, les sélections du sélecteur sont limitées à la session et ne réécrivent jamais la valeur par défaut persistante de l’agent dans openclaw.json. /models add est obsolète et renvoie un message au lieu d’enregistrer des modèles depuis la discussion.
• /model conserve immédiatement la nouvelle sélection de session. Si l’agent est inactif, l’exécution suivante l’utilise immédiatement ; si une exécution est déjà active, le changement est mis en file d’attente jusqu’au prochain point de nouvelle tentative propre (ou un point ultérieur, si l’activité des outils ou la sortie de la réponse a déjà commencé).
• /model default efface la sélection de session afin qu’elle hérite à nouveau du modèle principal configuré.
• Une référence /model sélectionnée par l’utilisateur est stricte pour cette session : si elle devient inaccessible, la réponse échoue de manière visible au lieu de recourir silencieusement aux modèles de secours définis dans agents.defaults.model.fallbacks. Les valeurs par défaut configurées et les modèles principaux des tâches Cron continuent d’utiliser les chaînes de secours.
• /model status fournit la vue détaillée : les candidats d’authentification par fournisseur et, lorsqu’il est configuré, le point de terminaison baseUrl du fournisseur ainsi que le mode api.
• Les références de modèles sont analysées en les scindant au premier / ; saisissez provider/model. Si l’ID du modèle contient lui-même / (comme avec OpenRouter), incluez le préfixe du fournisseur, par exemple /model openrouter/moonshotai/kimi-k2. Si vous omettez le fournisseur, OpenClaw essaie : (1) une correspondance d’alias, (2) une correspondance unique avec un fournisseur configuré pour cet ID de modèle exact sans préfixe, (3) le fournisseur par défaut configuré (solution de secours obsolète) — et, si ce fournisseur n’expose plus le modèle par défaut configuré, le premier couple fournisseur/modèle configuré à la place, afin d’éviter d’afficher une valeur par défaut obsolète correspondant à un fournisseur supprimé.
• Les références de modèles sont normalisées en minuscules ; les ID de fournisseurs doivent autrement correspondre exactement, utilisez donc l’ID annoncé par le plugin.

​

CLI

openclaw models status
openclaw models list
openclaw models set <provider/model>
openclaw models set-image <provider/model>
openclaw models scan
openclaw models aliases list|add|remove
openclaw models fallbacks list|add|remove|clear
openclaw models image-fallbacks list|add|remove|clear
openclaw models auth list|add|login|paste-api-key|paste-token|setup-token|order

​

Registre des modèles (models.json)

​

Ressources associées

• Environnements d’exécution des agents — OpenClaw, Codex et autres environnements d’exécution de boucles d’agents
• Référence de configuration — clés de configuration des modèles
• Génération d’images — configuration des modèles d’images
• Basculement de modèle — chaînes de secours
• Fournisseurs de modèles — routage des fournisseurs et authentification
• Référence de la CLI des modèles — référence complète des commandes et des options
• Génération musicale — configuration des modèles musicaux
• Génération de vidéos — configuration des modèles vidéo