Les modèles d’OpenClaw

La sélection de modèle ressemble à un réglage unique et forme en réalité un petit système : un principal, une chaîne de replis, une rotation d’identifiants dans un fournisseur, une politique qui peut restreindre les surcharges, et une commande de chat dont la portée dépend d’options et d’autorité. Avoir le bon modèle mental supprime l’essentiel des échecs déroutants, à commencer par la différence entre un défaut configuré et un choix que vous avez fait.

Comment une référence se résout

• L’ordre est simple : le principal configuré est essayé d’abord, puis les replis configurés dans l’ordre, la rotation des profils d’authentification ayant lieu à l’intérieur d’un fournisseur avant qu’OpenClaw ne passe au modèle de repli suivant.
• Autour s’articulent plusieurs surfaces : une table d’alias et de réglages par modèle, une portée de sélection qui décide de ce qu’une commande sans option change, une politique d’autorisation optionnelle, un modèle utilitaire moins coûteux pour les tâches internes courtes comme les titres générés et la narration de progression, un modèle d’images utilisé seulement quand le principal n’accepte pas les images, un modèle de documents pour l’outil de fichiers, et des modèles de médias pour les outils de génération.
• Quand le modèle utilitaire n’est pas défini, OpenClaw utilise le petit modèle par défaut déclaré par le fournisseur principal quand il existe, sinon le principal lui-même ; le mettre à une chaîne vide désactive ce routage, et un titre généré réessaie une fois avec le principal quand un modèle utilitaire distinct échoue.
• L’origine d’une sélection change sa rigueur : un défaut configuré utilise la chaîne de replis, un repli automatique est un état de récupération temporaire régulièrement resondé et effacé au rétablissement, une tâche planifiée fournit son propre principal tout en utilisant les replis configurés sauf si elle passe une liste vide, et une sélection utilisateur est exacte.

Une référence de modèle choisit un fournisseur et un modèle, pas le runtime d’agent de bas niveau.

Modèle refusé, et pourquoi les réponses s’arrêtent

Sans politique d’autorisation, vous pouvez choisir explicitement un fournisseur et un modèle même absents du catalogue du sélecteur, parce que le catalogue fournit des choix de navigation et des métadonnées plutôt qu’une liste blanche implicite, la disponibilité, la compatibilité de runtime et l’authentification étant vérifiées séparément. Quand la politique n’est pas vide, elle devient la liste blanche de la commande de chat, des surcharges de session et de l’option en ligne de commande, et choisir en dehors renvoie avant toute réponse un message nommant la clé exacte à modifier. Le correctif est d’ajouter le modèle, d’ajouter un joker de fournisseur, de vider la liste, ou de choisir dans la commande de liste. Les jokers sont des préfixes terminaux, une entrée à l’échelle d’un fournisseur couvrant tous ses modèles et un préfixe d’espace de noms plus étroit seulement cet espace, ce qui laisse de nouveaux modèles apparaître sans modifier la politique. Les modèles locaux exigent la référence complète préfixée par le fournisseur plutôt qu’un simple nom de fichier.

La commande de chat

• Sans option de portée, la commande ne change que la session courante ; l’option de session est explicite, l’option d’agent demande aussi une mise à jour du modèle configuré de cet agent, et l’option globale demande aussi une mise à jour du défaut partagé, les deux écritures configurées exigeant une autorité de propriétaire ou d’administrateur.
• Une référence choisie par l’utilisateur est stricte pour cette session : si elle devient injoignable la réponse échoue visiblement au lieu de traverser les replis configurés, et les épinglages explicites de modèle et de profil survivent aux réinitialisations, au renouvellement de session, à la compaction et aux fenêtres de refroidissement tant qu’ils restent valides.
• Les références sont analysées en coupant au premier séparateur, un identifiant de modèle contenant un séparateur exige donc son préfixe de fournisseur ; omettre le fournisseur essaie un alias, puis une correspondance unique parmi les fournisseurs configurés, puis le fournisseur par défaut configuré comme repli déprécié, la casse exacte l’emportant sur les correspondances insensibles à la casse.

Les fournisseurs de modèles d’OpenClaw couvre le versant fournisseur et Le basculement de modèles d’OpenClaw les règles de rotation et de refroidissement derrière la chaîne.

Changer de modèle en pleine session

La documentation est inhabituellement directe : choisissez le modèle à la création de la session quand c’est possible, parce que le changer en cours de route est une opération avancée. La transcription survit, mais le modèle suivant peut avoir une autre fenêtre de contexte, un autre comportement d’invite et d’outils, ou une autre implémentation de cache, le changement pouvant donc réduire la continuité, forcer une compaction plus tôt, ou perdre la réutilisation du cache et coûter plus cher. Garder le niveau de réflexion stable compte pour la même raison, puisque chez certains fournisseurs changer l’effort change l’état de requête réutilisable et force le tour suivant à retraiter la conversation. Le catalogue lui-même est préparé une fois par la passerelle pour toutes les surfaces, ouvrir un sélecteur lit donc des lignes publiées au lieu de lancer une découverte, et un rafraîchissement explicite est ce qui demande de nouveaux modèles. L’authentification des modèles OpenClaw est l’identifiant derrière la sélection et La configuration OpenClaw les clés qui la contiennent.

Sur Diali

Sur Diali le catalogue de modèles et ses identifiants sont gérés par la plateforme, la configuration d’exécution étant générée depuis le tableau de bord et remplacée à chaque version, la sélection est donc un choix dans le tableau de bord et non une édition de fichier. OpenClaw hébergé sur Diali décrit l’assistant hébergé et Les tarifs Diali les offres dans lesquelles il est livré.

• Principal, puis replis, avec rotation d’identifiants dans un fournisseur.
• Votre propre sélection est stricte et échoue visiblement.
• Choisissez le modèle à l’ouverture de la session, pas à mi-parcours.