OpenClaw WebUI 启动显示 Not Found 错误排查

OpenClaw WebUI 启动异常排查

部分用户在 Windows 10 环境下通过 pnpm 或 npm 安装 OpenClaw 后，启动 WebUI 可能会遇到页面空白或直接显示 Not Found 的情况。

这通常是因为旧版本中 Web 界面路径未自动指定导致的，新版已修复该问题。若仍在使用旧版，需手动修正配置。

问题现象

浏览器访问时无法加载资源，界面留白或报错：

解决方案

需要手动修改项目根目录下的 openclaw.json 配置文件，明确指定控制台的根路径。

Windows 系统的默认安装路径通常位于：

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

注意：虽然 Windows 习惯用反斜杠，但在配置文件中使用正斜杠 / 兼容性更好。

将以下配置项添加到 openclaw.json 中：

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

保存文件后重启服务即可生效。如果不确定自己的安装路径，可以在 node_modules 目录下查找 openclaw 文件夹进行确认。