OpenClaw Web UI 访问报错 Not Found 排查与修复

OpenClaw Web UI 无法访问问题排查

最近遇到 OpenClaw 的 Web UI 打不开，一直报 Not Found。折腾了一圈发现是路径解析的问题，这里把踩坑经验和解决方案整理一下，希望能帮到同样遇到这问题的朋友。

根本原因分析

Gateway 里的 resolveControlUiRootSync 函数在自动查找控制 UI 目录时，默认并没有把 node_modules/openclaw/dist/control-ui 纳入候选路径。如果你尝试手动指定相对路径，往往还会因为工作目录解析偏差导致找不到文件，最终抛出 404。

解决方案

这里分享一个稳妥的解决思路，亲测有效。

1. 迁移 UI 文件

先把控制 UI 的文件从 node_modules 里拷出来放到项目根目录。注意目录名最好只用英文，别带符号，像横杠或下划线有时候会引起混淆，建议保持简洁。

例如：

E:\你的实际目录\control-ui

2. 修改配置文件

打开配置文件 openclaw.json，用绝对路径指过去。在 JSON 配置中，Windows 路径的反斜杠需要转义，写成双反斜杠。

{
  "controlUi": {
    "enabled": true,
    "root": "E:\\你的实际安装的目录\\control-ui",
    "allowInsecureAuth": true,
    "dangerouslyDisableDeviceAuth": true
  }
}

这样配置后，重启服务应该就能正常访问了。如果还有问题，记得检查路径是否真实存在，以及权限是否足够。

小结

这类问题通常不是代码逻辑错误，而是环境配置细节没对上。以后遇到类似的路径找不到的情况，优先检查绝对路径和特殊字符干扰，能省不少调试时间。