Configuración de autenticación en OpenClaw

Configurar la autenticación suele ser la parte más tediosa al probar herramientas nuevas. Lidiar con variables de entorno que no se cargan o tokens que caducan justo cuando estás a mitad de una tarea importante es un dolor de cabeza constante para cualquier desarrollador.

Si quieres que OpenClaw se comunique con los modelos de Anthropic sin fricciones, esta guía te muestra el camino más corto para dejarlo funcionando en pocos minutos.

Requisitos previos

• Suscripción a Claude Max o Pro (solo si usas claude setup-token)
• Claude Code CLI instalado (el comando claude debe estar disponible)

Inicio rápido

OpenClaw soporta OAuth y API keys. Para cuentas de Anthropic, mi recomendación es usar una API key. Si prefieres usar tu suscripción de Claude, utiliza el token generado por claude setup-token.

1. Configuración recomendada (Anthropic API key)

Si usas Anthropic de forma directa, este es el método más fiable:

1. Crea una API key en el Anthropic Console.
2. Configúrala en el gateway host (la máquina donde ejecutas openclaw gateway):

export ANTHROPIC_API_KEY="..."
openclaw models status

3. Si tu Gateway corre bajo systemd o launchd, guarda la clave en ~/.openclaw/.env para que el daemon pueda leerla:

cat >> ~/.openclaw/.env <<'EOF'
ANTHROPIC_API_KEY=...
EOF

Reinicia el proceso del Gateway y verifica la conexión:

openclaw models status
openclaw doctor

Si prefieres no gestionar variables de entorno a mano, usa el asistente de configuración: openclaw onboard.

2. Suscripción de Anthropic (setup-token)

Si usas una suscripción de Claude en lugar de la API de pago por uso, ejecuta esto en tu gateway host:

claude setup-token

Luego, vincula ese token en OpenClaw:

openclaw models auth setup-token --provider anthropic

Si el token se generó en otra máquina, puedes pegarlo manualmente:

openclaw models auth paste-token --provider anthropic

Nota: Si recibes un error indicando que la credencial solo es válida para Claude Code, deberás cambiar obligatoriamente a una Anthropic API key.

Control de credenciales

Por sesión (comandos de chat)

Puedes fijar una credencial específica usando /model <alias-o-id>@<profileId>. Por ejemplo: anthropic:default o anthropic:work.

• Usa /model o /model list para ver un selector rápido.
• Usa /model status para ver los detalles del endpoint y el perfil de autenticación activo.

Por agente (anulación vía CLI)

Para forzar un orden de perfiles de autenticación en un agente específico:

openclaw models auth order set --provider anthropic anthropic:default

Si quieres ver el orden actual o borrarlo:

openclaw models auth order get --provider anthropic
openclaw models auth order clear --provider anthropic

Solución de problemas

”No credentials found”

Si el perfil de Anthropic no aparece, ejecuta claude setup-token en el gateway host y comprueba el estado:

openclaw models status

Token expirado o por expirar

Ejecuta openclaw models status para identificar qué perfil está fallando. Si el perfil desapareció, vuelve a ejecutar claude setup-token y pega el token de nuevo. Para automatizar esta revisión en scripts, usa:

openclaw models status --check

(Retorna 1 si falta el token o está expirado; 2 si está cerca de expirar).

---

¿Necesitas ayuda personalizada con tu configuración? Prueba nuestro AI Setup Assistant.

Próximos pasos

• /concepts/oauth: Flujo completo de OAuth y almacenamiento.
• /automation/auth-monitoring: Scripts para systemd y Termux.
• Help: Detalles sobre herencia de variables de entorno.