OpenClaw Web UI 访问报错 Not Found 排查与修复
在使用 OpenClaw 时，偶尔会遇到 Web UI 页面无法访问并提示 Not Found 的情况。这通常不是服务挂了，而是路径解析的问题。
根本原因其实比较隐蔽：Gateway 里的 resolveControlUiRootSync 函数在自动查找控制 UI 目录时，默认没有把 node_modules/openclaw/dist/control-ui 当作有效候选路径。有时候即使手动指定了相对路径，也会因为运行时的'工作目录'上下文不一致，导致找不到文件。
解决这个问题有两个路子，看你的偏好。
第一种是把 UI 文件直接挪到项目根目录。这样最稳妥，不用管复杂的依赖结构。不过要注意，新建的目录名最好只用英文字母，别带 - 或 _ 这种符号，有些环境对特殊字符处理不太友好。
第二种是直接在配置里写死绝对路径。这种方式更灵活，适合不想复制文件的场景。你需要编辑项目里的 openclaw.json，把 controlUi 部分配好。
{
"controlUi": {
"enabled": true,
"root": "<项目根目录>/control-ui",
"allowInsecureAuth": true,
"dangerouslyDisableDeviceAuth": true
}
}
填路径的时候记得注意转义，尤其是 Windows 环境下，反斜杠可能需要双重转义。改完保存重启一下，应该就能正常访问了。
