OpenClaw WebUI 空白页及 Not Found 问题排查与修复

在使用 OpenClaw 进行开发时，部分 Windows 10 用户反馈启动 WebUI 后页面空白，甚至直接提示 Not Found。这通常发生在通过 pnpm 或 npm 安装的场景下，原因是 Web UI 的静态资源路径未被正确识别。好在较新的版本已经修复了这个问题，如果你使用的是旧版，可以通过手动修改配置文件来解决。

首先，你需要找到项目根目录下的 openclaw.json 文件。如果找不到，可以尝试在模块安装路径下查找。根据常见的 Node.js 全局安装结构，路径通常位于：

C:\Users\你的用户名\AppData\Roaming\npm\node_modules\openclaw\dist\control-ui

确认路径无误后，打开 openclaw.json 并在配置中添加 controlUi 字段，明确指定 root 路径。注意 JSON 格式中斜杠的方向，建议统一使用正斜杠 / 以避免转义问题。

示例配置如下：

{
  "controlUi": {
    "root": "C:/Users/86135/AppData/Roaming/npm/node_modules/openclaw/dist/control-ui"
  }
}

保存文件并重启服务，WebUI 应该就能正常加载了。如果依然无法访问，请检查端口是否被占用或防火墙设置。