hice algunas modificaciones, pero creo que logra el resultado que indicás con menos código. (El while no es necesario, porque cada vez que das al botón llamás a la función, no es necesario tener un loop) Al llamar a la función solo verificamos las condiciones y ejecutamos lo deseado.

Hice cambios solo en el archivo JavaScript, quedaría así:

    //Control de acceso
    let i = 3; //valor inicial para el número de intentos
    
    function pwcheck() {
      const contrasena = document.getElementById("caja").value;
      const campoMensaje = document.getElementById("mensaje");
    
      if (contrasena === "acceso" && i > 0) {
        campoMensaje.innerHTML = "";
        location.href = "okpass.html";
      } else if (contrasena !== "acceso" && i >= 1) {
        i--;
        //Volcamos el error en la caja de aviso
        campoMensaje.innerHTML = "Error de acceso, te quedan " + i + " intentos";
        document.getElementById("caja").value = "";
        document.getElementById("caja").focus().value = "";
      }
    }