Configuración de OAuth y autenticación en OpenClaw

Gestionar tokens de acceso y sesiones de login suele ser un dolor de cabeza. Seguro te ha pasado: te identificas en una herramienta y, de la nada, tu sesión en otra aplicación expira porque los tokens de refresco se invalidan entre sí. Es frustrante y corta tu ritmo de trabajo.

OpenClaw soluciona esto centralizando la autenticación. En lugar de pelear con archivos de configuración dispersos, usa un sistema de perfiles que mantiene tus sesiones activas y organizadas, incluso si manejas varias cuentas de OpenAI o Anthropic al mismo tiempo.

Requisitos previos

• OpenClaw instalado en tu sistema.
• Una suscripción activa a OpenAI Codex (ChatGPT OAuth) o Anthropic.
• Acceso a la terminal para ejecutar comandos CLI.

Inicio rápido

Configura tu autenticación en menos de 5 minutos siguiendo estos pasos:

1. Inicia el asistente: Ejecuta openclaw onboard y elige el proveedor que prefieras.

2. Para Anthropic (Subscription Auth): Primero, genera el token en tu terminal con claude setup-token. Luego, asígnalo a OpenClaw:

   openclaw models auth setup-token --provider anthropic

3. Para OpenAI Codex (OAuth): Elige openai-codex en el asistente. Se abrirá una ventana en tu navegador para el login. Si estás en un entorno remoto, copia y pega la URL de redirección cuando la terminal lo solicite.

4. Verifica la conexión: Confirma que todo está en orden con este comando:

   openclaw models status

Gestión de tokens y almacenamiento

OpenClaw utiliza un concepto llamado token sink. Esto significa que centraliza los tokens en auth-profiles.json para evitar que diferentes clientes (como Claude Code o Codex CLI) invaliden tus sesiones al generar nuevos refresh tokens.

Los archivos se guardan por agente en estas rutas:

• Perfiles de autenticación: ~/.openclaw/agents/<agentId>/agent/auth-profiles.json
• Caché de ejecución: ~/.openclaw/agents/<agentId>/agent/auth.json (no edites este archivo manualmente).

Si necesitas usar plugins de proveedores específicos con sus propios flujos, usa:

openclaw models auth login --provider \<id\>

Cuentas múltiples

Si manejas cuentas personales y de trabajo, te recomiendo usar agentes separados para mantener una isolación total:

openclaw agents add work
openclaw agents add personal

También puedes usar varios perfiles en un mismo agente y alternar entre ellos en el chat usando comandos de barra: /model Opus@anthropic:work

Solución de problemas

• Cierres de sesión aleatorios: Esto ocurre cuando usas OpenClaw y otra CLI oficial al mismo tiempo. La solución es usar OpenClaw como el “token sink” principal para que gestione la rotación de tokens de forma determinista.
• Fallo en el callback de OAuth (entornos remotos/headless): Si el navegador no puede conectar con http://127.0.0.1:1455, copia manualmente la URL completa a la que fuiste redirigido y pégala en la terminal de OpenClaw para completar el intercambio de tokens.

¿Necesitas ayuda con una configuración específica? Prueba nuestro AI Setup Assistant.

Próximos pasos

• /concepts/model-failover
• /tools/slash-commands
• /gateway/configuration