Soluciona errores de OpenClaw: Guía de failover y auth

¿Alguna vez te ha pasado que tu proceso se detiene de golpe porque una API decidió dejar de responder? Es frustrante ver cómo un error de rate-limit arruina el flujo de trabajo justo a la mitad. Configurar un sistema de respaldo es la mejor forma de evitar estos dolores de cabeza y mantener tus herramientas activas sin intervención manual.

El failover no es solo una red de seguridad, es la base para que tus aplicaciones sean confiables. Aquí te explico cómo manejarlo en OpenClaw y cómo solucionar los errores más comunes de credenciales.

¿Cómo funciona el failover?

El failover ocurre en dos etapas:

1. Rotación de auth profile dentro del mismo proveedor.
2. Model fallback hacia el siguiente modelo definido en agents.defaults.model.fallbacks.

Se aplican tiempos de espera (exponential backoff) a los perfiles que fallan. De esta manera, OpenClaw puede seguir respondiendo incluso si un proveedor tiene límites de tasa o fallos temporales.

¿Qué significa “No credentials found for profile ‘anthropic:default’”?

Significa que el sistema intentó usar el ID de auth profile anthropic:default, pero no pudo encontrar las credenciales en el almacén de autenticación esperado.

Lista de verificación para “No credentials found for profile anthropic:default”

1. Confirma dónde viven los auth profiles:

   • Actual: ~/.openclaw/agents/<agentId>/agent/auth-profiles.json
   • Legado: ~/.openclaw/agent/* (migrado por openclaw doctor)

2. Confirma que el Gateway cargue tu variable de entorno

   • Si configuraste ANTHROPIC_API_KEY en tu terminal pero ejecutas el Gateway vía systemd/launchd, es posible que no la herede.
   • Ponla en ~/.openclaw/.env o activa env.shellEnv.

3. Asegúrate de estar editando el agente correcto

   • Las configuraciones multi-agente implican que puede haber varios archivos auth-profiles.json.

4. Verifica el estado del modelo y la autenticación

   openclaw models status

Lista de verificación para “No credentials found for profile anthropic”

Esto significa que la ejecución está anclada a un auth profile de Anthropic, pero el Gateway no lo encuentra.

Usa un setup-token:

claude setup-token
openclaw models auth setup-token --provider anthropic

Si prefieres usar una API key en su lugar:

• Pon ANTHROPIC_API_KEY en ~/.openclaw/.env dentro del host del gateway.
• Limpia cualquier orden anclado:

  openclaw models auth order clear --provider anthropic

Confirma que ejecutas los comandos en el host del gateway

• En modo remoto, los auth profiles viven en la máquina del gateway, no en tu laptop.

¿Por qué también intentó usar Google Gemini y falló?

Si tu configuración de modelo incluye Google Gemini como fallback (o cambiaste a un atajo de Gemini), OpenClaw lo intentará durante el model fallback. Si no has configurado las credenciales de Google, verás el error No API key found for provider "google".

Solución: Proporciona la autenticación de Google o elimina los modelos de Google en agents.defaults.model.fallbacks.

AI Setup Assistant

Pasos siguientes

• Configuración de proveedores
• Gestión de agentes