Modelos
Referencia CLI para openclaw models (status/list/set/scan, aliases, fallback, auth).
Descubrimiento, escaneo y configuración de modelos (modelo predeterminado, fallback, perfiles de auth).
Relacionado:
- Proveedores + modelos: ''Modelos''
- Configuración de auth de proveedor: ''Primeros Pasos''
Comandos comunes
openclaw models status openclaw models list openclaw models set <model-or-alias> openclaw models scan
''openclaw models status'' muestra el default/fallback resuelto más resumen de auth.
Cuando el snapshot de uso del proveedor está disponible, la sección de estado OAuth/token incluye
encabezados de uso del proveedor.
Añade ''--probe'' para ejecutar sondas de auth en vivo contra cada perfil de proveedor configurado.
Las sondas son peticiones reales (pueden consumir tokens y activar límites de tasa).
Usa ''--agent <id>'' para verificar estado de modelo/auth para el agente configurado. Cuando se omite,
''OPENCLAW_AGENT_DIR''/''PI_CODING_AGENT_DIR'' se usa si está establecido para el comando, de lo contrario
el agente predeterminado configurado.
Notas:
- ''models set <modelo-o-alias>'' acepta ''proveedor/modelo'' o alias.
- Las referencias de modelo se resuelven dividiendo en la ''primera'' ''/''. Si el ID del modelo contiene ''/'' (estilo OpenRouter), incluye prefijo de proveedor (ej., ''openrouter/moonshotai/kimi-k2'').
- Si el proveedor se omite, OpenClaw trata la entrada como alias o modelo para el ''proveedor predeterminado'' (solo válido cuando el ID del modelo no tiene ''/'').
`models status`
Opciones:
- ''--json''
- ''--plain''
- ''--check'' (salida 1=expirado/faltante, 2=expirado)
- ''--probe'' (sonda en vivo de perfiles de auth configurados)
- ''--probe-provider <nombre>'' (sondear un proveedor)
- ''--probe-profile <id>'' (repetir o IDs de perfil separados por coma)
- ''--probe-timeout <ms>''
- ''--probe-concurrency <n>''
- ''--probe-max-tokens <n>''
Aliases + Fallbacks
openclaw models aliases list openclaw models fallbacks list
Perfiles de Auth
openclaw models auth add openclaw models auth login --provider <id> openclaw models auth setup-token openclaw models auth paste-token
''models auth login'' ejecuta el flujo de auth del plugin del proveedor (OAuth/API key). Usa
''openclaw plugins list'' para ver qué proveedores están instalados.
Notas:
- ''setup-token'' solicita valores de token de configuración (genéralo con ''claude setup-token'' en cualquier máquina).
- ''paste-token'' acepta cadena de token desde otro lugar o autogenerada.