OpenClaw Web UI 访问报错排查
遇到 Web UI 无法访问且提示 Not Found 的情况，核心问题往往出在 Gateway 对控制 UI 目录的解析逻辑上。具体表现为 resolveControlUiRootSync 函数在自动查找时，没有把 node_modules/openclaw/dist/control-ui 纳入候选路径，导致相对路径失效。
针对这个问题，有两种可行的修复方案。
方案一：手动迁移文件
最直接的办法是将控制 UI 文件从依赖包中剥离出来。你需要把 node_modules/openclaw/dist/control-ui 整个目录复制到项目根目录下。注意，新建的目录名尽量使用纯英文，避免包含 - 或 _ 等特殊符号，否则可能引发路径解析混淆。
方案二：配置绝对路径
如果不想移动文件，可以直接在配置文件中指定绝对路径。编辑 openclaw.json，找到 controlUi 节点，设置 root 为实际安装目录的完整路径。
{
"controlUi": {
"enabled": true,
"root": "E:\\你的实际安装目录\\control-ui",
"allowInsecureAuth": true,
"dangerouslyDisableDeviceAuth": true
}
}
修改完成后记得重启服务，确保配置生效。