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

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
  }
}

修改完成后记得重启服务，确保配置生效。