Troubleshooting

Objetivo

Centralizar sintomas, causas posibles y pasos de diagnostico para la futura operacion de OpenClaw.

Casos previstos

El contenedor no inicia

• Revisar docker compose ps
• Revisar docker compose logs
• Confirmar variables obligatorias
• Confirmar volumenes y permisos

El servicio inicia pero no responde

• Revisar puertos publicados
• Revisar proxy o firewall
• Confirmar URL base y resolucion DNS

Se pierde persistencia

• Revisar bind mounts o volumenes
• Confirmar rutas reales en host
• Verificar politica de reemplazo de contenedores

Fallan integraciones o modelos

• Revisar configuracion del proveedor
• Confirmar secretos fuera de Git
• Validar limites, cuotas o credenciales vencidas

Hay sospecha de riesgo de seguridad

• Aislar exposicion
• Preservar evidencia no sensible
• Detener cambios hasta auditar
• Revisar accesos, skills y logs