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
}
}
这样配置后，重启服务应该就能正常访问了。如果还有问题，记得检查路径是否真实存在，以及权限是否足够。
小结
这类问题通常不是代码逻辑错误，而是环境配置细节没对上。以后遇到类似的路径找不到的情况，优先检查绝对路径和特殊字符干扰，能省不少调试时间。