Configura tus perfiles de autenticación en OpenClaw

Seguro que te ha pasado: tienes varias cuentas de IA, algunas para el trabajo y otras para tus proyectos personales, y gestionar las credenciales se vuelve un caos. Configurar cada API key a mano cada vez que cambias de contexto es frustrante y te quita ritmo de desarrollo.

Auth Profiles

Entender los perfiles de autenticación y la gestión de credenciales es clave para trabajar de forma fluida.

¿Qué es un auth profile?

Un auth profile es un registro de credenciales con nombre (ya sea OAuth o una API key) vinculado a un provider. Los perfiles viven en:

~/.openclaw/agents/<agentId>/agent/auth-profiles.json

¿Cuáles son los IDs de perfil típicos?

OpenClaw utiliza IDs con el prefijo del provider, como estos:

• anthropic:default (común cuando no existe una identidad de email)
• anthropic:<email> para identidades OAuth
• IDs personalizados que tú elijas (por ejemplo, anthropic:work)

¿Puedo controlar qué auth profile se intenta primero?

Sí. La configuración admite metadatos opcionales para los perfiles y un orden específico por provider (auth.order.<provider>).

OpenClaw puede saltarse un perfil temporalmente si está en un periodo corto de cooldown (por rate limits, timeouts o fallos de autenticación) o en un estado disabled más largo (por temas de facturación o créditos insuficientes).

Para revisar esto, ejecuta openclaw models status --json y comprueba auth.unusableProfiles.

Establecer un orden por agente:

# Lock rotation to a single profile
openclaw models auth order set --provider anthropic anthropic:default

# Set an explicit order (fallback within provider)
openclaw models auth order set --provider anthropic anthropic:work anthropic:default

# Clear override
openclaw models auth order clear --provider anthropic

OAuth vs API key—¿cuál es la diferencia?

OpenClaw soporta ambas opciones:

• OAuth suele usar el acceso por suscripción (donde sea aplicable)
• API keys utilizan el modelo de pago por token

El wizard soporta específicamente el setup-token de Anthropic y el OAuth de OpenAI Codex, y puede guardar las API keys por ti.

AI Setup Assistant

Pasos siguientes

• Configuración de Providers
• Gestión de Modelos
• Solución de problemas de Auth
• Uso de CLI