Cómo gestionar tus modelos y autenticación en OpenClaw

¿Alguna vez has perdido tiempo saltando entre diferentes proveedores de IA solo para cambiar de modelo o revisar si tu API key sigue activa? Configurar cada proveedor por separado y gestionar los fallbacks puede volverse un caos rápidamente cuando tu flujo de trabajo depende de varias herramientas.

Tener un control centralizado te ayuda a evitar interrupciones. En lugar de editar archivos de configuración complejos cada vez que un modelo falla, puedes gestionar todo desde tu terminal de forma directa.

Requisitos previos

Para seguir esta guía, asegúrate de tener lo siguiente:

• OpenClaw instalado en tu sistema.
• Providers instalados (puedes ver la lista ejecutando openclaw plugins list).

Inicio rápido

Sigue estos pasos para configurar tus modelos en menos de 5 minutos:

1. Escanea tus modelos: Ejecuta el comando para detectar qué modelos tienes disponibles.

   openclaw models scan

2. Configura tu modelo principal: Elige el modelo que quieres usar por defecto.

   openclaw models set <model-or-alias>

3. Verifica el estado: Revisa si tus credenciales y modelos están listos.

   openclaw models status

4. Autenticación rápida: Si necesitas loguearte en un proveedor específico, usa el flujo de autenticación integrado.

   openclaw models auth login --provider <id>

Gestión de comandos y modelos

El comando openclaw models status te muestra los modelos por defecto, los fallbacks y un resumen de la autenticación. Si quieres probar que las credenciales funcionan con peticiones reales, añade el flag --probe. Ten en cuenta que esto consume tokens y puede activar límites de ratio.

Identificación de modelos

Cuando uses models set, puedes usar el formato provider/model o un alias. OpenClaw divide el nombre en el primer /. Si usas OpenRouter y el ID del modelo ya contiene una barra, incluye el prefijo del provider: openrouter/moonshotai/kimi-k2. Si no incluyes el provider, se usará el provider por defecto (esto solo funciona si el ID del modelo no tiene barras).

Perfiles de autenticación

Puedes gestionar cómo te conectas a cada servicio con estos comandos:

openclaw models auth add
openclaw models auth login --provider <id>
openclaw models auth setup-token
openclaw models auth paste-token

• setup-token: Te pide un valor generado previamente con claude setup-token.
• paste-token: Acepta un token generado en otro lugar o mediante procesos automáticos.
• models status: Verás marker(<value>) para datos que no son secretos (como OPENAI_API_KEY o ollama-local) en lugar de ocultarlos completamente.

Solución de problemas

Si encuentras errores, aquí tienes las soluciones basadas en los diagnósticos de la herramienta:

• Error en scripts o automatización: Usa openclaw models status --check. El comando devolverá un código de salida 1 si la sesión ha expirado o falta, y 2 si está a punto de expirar.
• Uso de Anthropic: Aunque existe compatibilidad técnica para setup-token, Anthropic ha bloqueado anteriormente el uso de suscripciones fuera de Claude Code. Verifica sus términos actuales antes de usarlo.
• Inspeccionar un agente específico: Si necesitas revisar el estado de un agente que no es el predeterminado, usa el flag --agent <id>. Esto ignorará las variables OPENCLAW_AGENT_DIR o PI_CODING_AGENT_DIR.

Para resolver dudas específicas sobre tu configuración, utiliza el AI Setup Assistant.

Próximos pasos

• Providers y modelos
• Configuración inicial de autenticación