OpenClaw Web UI 访问报错 Not Found 问题排查与解决

问题现象

启动 OpenClaw 后，Web UI 页面提示 Not Found，无法访问。

原因分析

这通常是因为 Gateway 的 resolveControlUiRootSync 函数在自动查找控制 UI 目录时，没有把 node_modules/openclaw/dist/control-ui 纳入候选路径。如果手动指定相对路径，又可能因为工作目录解析偏差导致找不到文件。

解决方案

要彻底解决这个问题，建议采用绝对路径方式，并规范目录结构。

首先，将控制 UI 文件从 node_modules/openclaw/dist/control-ui 复制到项目根目录下。新建一个名为 control-ui 的文件夹即可。注意目录名称尽量使用纯英文，避免包含 - 或 _ 等特殊符号，防止引起解析混淆。

接下来，编辑 openclaw.json 配置文件，明确指定 controlUi.root 的绝对路径。这里有个细节需要注意：在 JSON 格式中，Windows 的反斜杠需要转义，所以路径里的每个 \ 都要写成 \u005c。

配置示例如下：

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

保存文件后重启服务，通常就能正常访问了。如果仍有问题，请检查路径是否真实存在且权限无误。