Solución de Problemas
Verificaciones rápidas y soluciones comunes para problemas de configuración y runtime de OpenClaw
Primeros 60 segundos
Empieza con estos comandos para obtener señal rápidamente:
openclaw status openclaw status --all openclaw gateway probe openclaw logs --follow openclaw doctor
Si el problema persiste, ejecuta una investigación más profunda:
openclaw status --deep
Casos comunes
Más casos comunes próximamente.
El comando openclaw no se encuentra
Esto suele ser un problema de PATH o instalación. Empieza aquí:
- Verificación de Node/npm/PATH
Si aún falla, vuelve a ejecutar el instalador y asegúrate de que tu shell carga el PATH actualizado.
El instalador falla
Vuelve a ejecutar el instalador con registros detallados:
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --verbose
Para versiones beta:
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --beta --verbose
Al reportar problemas, incluye la salida de --verbose.
Si estás detrás de un proxy o intercepción TLS, prueba una red diferente y vuelve a ejecutar con registros detallados.
El Dashboard dice no autorizado
- Solución de problemas del Gateway
Usa la URL del dashboard tokenizada (o headers de identidad Tailscale de confianza) para satisfacer la autenticación.
La interfaz web no carga
- Solución de problemas del Gateway
Confirma que el gateway es alcanzable y que el puerto/modo bind coincide con tu red.
No puedo acceder a docs.openclaw.ai (error SSL)
Si ves ERR_CERT_DATE_INVALID, verifica la hora de tu sistema y configuración de inspección TLS.
Si ves NET::ERR_CERT_AUTHORITY_INVALID, tu red puede estar interceptando TLS.
- Prueba una red diferente (hotspot móvil).
- Desactiva la inspección TLS corporativa o instala la CA raíz apropiada.
Si aún falla, incluye el error completo del navegador y detalles del SO/red.
El probe RPC falla
- Solución de problemas del Gateway
Confirma que el daemon está ejecutándose y que el endpoint RPC es alcanzable.
La autenticación del modelo/proveedor falla
Verifica las credenciales del proveedor y el perfil de autenticación activo.
El modelo no está permitido
Si ves Model … is not allowed, la política del gateway lo está bloqueando.
Actualiza tu configuración para permitir el modelo o cambia a uno permitido.
- Verifica tu modelo predeterminado configurado en models.default.
- Verifica la disponibilidad del proveedor en openclaw models status.
- Si usas OAuth de suscripción, asegúrate de que el perfil correcto esté seleccionado.
Si no estás seguro, pega la salida sanitizada de <code>openclaw models status</code>.
Reportar un problema
Al pedir ayuda, incluye un resumen reproducible y estas salidas:
openclaw status --all
Adjunta openclaw status --all (los tokens están redactados) y una cola de registro relevante corta.