Passer au contenu principal

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
openclaw models

Découverte, analyse et configuration des modèles (modèle par défaut, solutions de repli, profils d’authentification). Associé :

​
Commandes courantes

openclaw models status
openclaw models list
openclaw models set <model-or-alias>
openclaw models scan
openclaw models status affiche les valeurs par défaut/solutions de repli résolues ainsi qu’un aperçu de l’authentification. Lorsque des instantanés d’utilisation des fournisseurs sont disponibles, la section d’état OAuth/clé API inclut les fenêtres d’utilisation des fournisseurs et les instantanés de quotas. Fournisseurs de fenêtres d’utilisation actuels : Anthropic, GitHub Copilot, Gemini CLI, OpenAI Codex, MiniMax, Xiaomi et z.ai. L’authentification d’utilisation provient des hooks propres au fournisseur lorsqu’ils sont disponibles ; sinon, OpenClaw se rabat sur les identifiants OAuth/clé API correspondants provenant des profils d’authentification, de l’environnement ou de la configuration. Dans la sortie --json, auth.providers est l’aperçu des fournisseurs tenant compte de l’environnement/de la configuration/du magasin, tandis que auth.oauth correspond uniquement à l’état des profils du magasin d’authentification. Ajoutez --probe pour exécuter des sondes d’authentification réelles sur chaque profil de fournisseur configuré. Les sondes sont de vraies requêtes (elles peuvent consommer des jetons et déclencher des limites de débit). Utilisez --agent <id> pour inspecter l’état modèle/authentification d’un agent configuré. En cas d’omission, la commande utilise OPENCLAW_AGENT_DIR/PI_CODING_AGENT_DIR s’ils sont définis, sinon l’agent par défaut configuré. Les lignes de sonde peuvent provenir de profils d’authentification, d’identifiants d’environnement ou de models.json. Pour diagnostiquer OAuth avec Codex, openclaw models status, openclaw models auth list --provider openai-codex et openclaw config get agents.defaults.model --json sont le moyen le plus rapide de confirmer si un agent possède un profil d’authentification openai-codex utilisable pour openai/* via le runtime Codex natif. Voir Configuration du fournisseur OpenAI. Remarques :
  • models set <model-or-alias> accepte provider/model ou un alias.
  • models list est en lecture seule : il lit la configuration, les profils d’authentification, l’état de catalogue existant et les lignes de catalogue appartenant aux fournisseurs, mais ne réécrit pas models.json.
  • La colonne Auth est au niveau fournisseur et en lecture seule. Elle est calculée à partir des métadonnées de profils d’authentification locaux, des marqueurs d’environnement, des clés fournisseur configurées, des marqueurs de fournisseur local, des marqueurs d’environnement/profil AWS Bedrock et des métadonnées d’authentification synthétiques de plugin ; elle ne charge pas le runtime du fournisseur, ne lit pas les secrets du trousseau, n’appelle pas les API des fournisseurs et ne prouve pas l’aptitude exacte à l’exécution modèle par modèle.
  • models list --all --provider <id> peut inclure des lignes de catalogue statiques appartenant au fournisseur provenant de manifestes de plugins ou des métadonnées de catalogue de fournisseurs intégrés, même lorsque vous ne vous êtes pas encore authentifié auprès de ce fournisseur. Ces lignes restent affichées comme indisponibles jusqu’à ce qu’une authentification correspondante soit configurée.
  • models list maintient le plan de contrôle réactif lorsque la découverte du catalogue fournisseur est lente. Les vues par défaut et configurées se rabattent sur des lignes de modèles configurées ou synthétiques après une courte attente et laissent la découverte se terminer en arrière-plan. Utilisez --all lorsque vous avez besoin du catalogue découvert complet exact et que vous êtes prêt à attendre la découverte fournisseur.
  • Un large models list --all fusionne les lignes de catalogue de manifeste par-dessus les lignes de registre sans charger les hooks de supplément du runtime fournisseur. Les chemins rapides de manifeste filtrés par fournisseur utilisent uniquement les fournisseurs marqués static ; les fournisseurs marqués refreshable restent adossés au registre/cache et ajoutent les lignes de manifeste comme suppléments, tandis que les fournisseurs marqués runtime restent sur la découverte registre/runtime.
  • models list garde distinctes les métadonnées natives du modèle et les plafonds du runtime. Dans la sortie tableau, Ctx affiche contextTokens/contextWindow lorsqu’un plafond effectif du runtime diffère de la fenêtre de contexte native ; les lignes JSON incluent contextTokens lorsqu’un fournisseur expose ce plafond.
  • models list --provider <id> filtre par identifiant de fournisseur, comme moonshot ou openai-codex. Il n’accepte pas les libellés d’affichage des sélecteurs interactifs de fournisseurs, comme Moonshot AI.
  • Les références de modèle sont analysées en scindant sur le premier /. Si l’ID de modèle inclut / (style OpenRouter), incluez le préfixe du fournisseur (exemple : openrouter/moonshotai/kimi-k2).
  • Si vous omettez le fournisseur, OpenClaw résout d’abord l’entrée comme un alias, puis comme une correspondance unique de fournisseur configuré pour cet ID de modèle exact, et seulement ensuite se rabat sur le fournisseur par défaut configuré avec un avertissement d’obsolescence. Si ce fournisseur n’expose plus le modèle par défaut configuré, OpenClaw se rabat sur le premier fournisseur/modèle configuré au lieu d’exposer une valeur par défaut obsolète d’un fournisseur supprimé.
  • models status peut afficher marker(<value>) dans la sortie d’authentification pour les espaces réservés non secrets (par exemple OPENAI_API_KEY, secretref-managed, minimax-oauth, oauth:chutes, ollama-local) au lieu de les masquer comme des secrets.

​
Analyse des modèles

models scan lit le catalogue public :free d’OpenRouter et classe les candidats pour une utilisation en solution de repli. Le catalogue lui-même est public, les analyses limitées aux métadonnées ne nécessitent donc pas de clé OpenRouter. Par défaut, OpenClaw essaie de sonder la prise en charge des outils et des images avec des appels de modèle réels. Si aucune clé OpenRouter n’est configurée, la commande se rabat sur une sortie limitée aux métadonnées et explique que les modèles :free nécessitent toujours OPENROUTER_API_KEY pour les sondes et l’inférence. Options :
  • --no-probe (métadonnées uniquement ; aucune recherche de configuration/secrets)
  • --min-params <b>
  • --max-age-days <days>
  • --provider <name>
  • --max-candidates <n>
  • --timeout <ms> (requête de catalogue et délai d’attente par sonde)
  • --concurrency <n>
  • --yes
  • --no-input
  • --set-default
  • --set-image
  • --json
--set-default et --set-image nécessitent des sondes réelles ; les résultats d’analyse limités aux métadonnées sont informatifs et ne sont pas appliqués à la configuration.

​
État des modèles

Options :
  • --json
  • --plain
  • --check (sortie 1=expiré/manquant, 2=expire bientôt)
  • --probe (sonde réelle des profils d’authentification configurés)
  • --probe-provider <name> (sonder un fournisseur)
  • --probe-profile <id> (identifiants de profils répétés ou séparés par des virgules)
  • --probe-timeout <ms>
  • --probe-concurrency <n>
  • --probe-max-tokens <n>
  • --agent <id> (identifiant d’agent configuré ; remplace OPENCLAW_AGENT_DIR/PI_CODING_AGENT_DIR)
--json réserve stdout à la charge utile JSON. Les diagnostics de profil d’authentification, de fournisseur et de démarrage sont routés vers stderr afin que les scripts puissent transmettre stdout directement à des outils comme jq. Catégories d’état des sondes :
  • ok
  • auth
  • rate_limit
  • billing
  • timeout
  • format
  • unknown
  • no_model
Cas de détail/code de raison de sonde à prévoir :
  • excluded_by_auth_order : un profil stocké existe, mais auth.order.<provider> explicite l’a omis ; la sonde signale donc l’exclusion au lieu d’essayer ce profil.
  • missing_credential, invalid_expires, expired, unresolved_ref : le profil est présent mais non éligible/résolvable.
  • no_model : l’authentification fournisseur existe, mais OpenClaw n’a pas pu résoudre un candidat de modèle sondable pour ce fournisseur.

​
Alias + solutions de repli

openclaw models aliases list
openclaw models fallbacks list

​
Profils d’authentification

openclaw models auth add
openclaw models auth list [--provider <id>] [--json]
openclaw models auth login --provider <id>
openclaw models auth setup-token --provider <id>
openclaw models auth paste-token
models auth add est l’assistant d’authentification interactif. Il peut lancer un flux d’authentification fournisseur (OAuth/clé API) ou vous guider vers un collage manuel de jeton, selon le fournisseur choisi. models auth list liste les profils d’authentification enregistrés pour l’agent sélectionné sans afficher de jeton, de clé API ou de matériel secret OAuth. Utilisez --provider <id> pour filtrer sur un fournisseur, comme openai-codex, et --json pour les scripts. models auth login exécute le flux d’authentification d’un plugin de fournisseur (OAuth/clé API). Utilisez openclaw plugins list pour voir quels fournisseurs sont installés. Utilisez openclaw models auth --agent <id> <subcommand> pour écrire les résultats d’authentification dans un magasin d’agent configuré spécifique. Le drapeau parent --agent est respecté par add, list, login, setup-token, paste-token et login-github-copilot. Pour les modèles OpenAI, --provider openai utilise par défaut la connexion au compte ChatGPT/Codex. Utilisez --method api-key uniquement lorsque vous voulez ajouter un profil de clé API OpenAI, généralement comme secours pour les limites d’abonnement Codex. L’ancienne graphie --provider openai-codex fonctionne toujours pour les scripts existants. Exemples : 
openclaw models auth login --provider openai --set-default
openclaw models auth login --provider openai --method api-key
openclaw models auth list --provider openai
Remarques :
  • setup-token et paste-token restent des commandes de jeton génériques pour les fournisseurs qui exposent des méthodes d’authentification par jeton.
  • setup-token nécessite un TTY interactif et exécute la méthode d’authentification par jeton du fournisseur (par défaut la méthode setup-token de ce fournisseur lorsqu’il en expose une).
  • paste-token accepte une chaîne de jeton générée ailleurs ou par automatisation.
  • paste-token nécessite --provider, demande la valeur du jeton et l’écrit dans l’identifiant de profil par défaut <provider>:manual, sauf si vous passez --profile-id.
  • paste-token --expires-in <duration> stocke une expiration absolue du jeton à partir d’une durée relative comme 365d ou 12h.
  • Note Anthropic : le personnel d’Anthropic nous a indiqué que l’utilisation de Claude CLI de type OpenClaw est à nouveau autorisée ; OpenClaw traite donc la réutilisation de Claude CLI et l’utilisation de claude -p comme autorisées pour cette intégration, sauf si Anthropic publie une nouvelle politique.
  • Anthropic setup-token / paste-token restent disponibles comme chemin de jeton OpenClaw pris en charge, mais OpenClaw privilégie désormais la réutilisation de Claude CLI et claude -p lorsqu’ils sont disponibles.

​
Associé