OpenClaw WebUI 空白页问题修复指南

在 Windows 10 系统安装 OpenClaw 时，可能会出现 WebUI 启动后显示空白或 Not Found 的情况。这是因为使用 pnpm 或 npm 安装时未正确指定 WebUI 路径，旧版本存在此问题，新版本已修复。

错误表现如下图所示：

WebUI 报错截图

解决方法是手动配置 control-ui 路径。

一般安装路径如下：

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

修改 openclaw.json 文件，添加以下参数：

{
  "controlUi": {
    "root": "C:/Users/你的用户名/AppData/Roaming/npm/node_modules/openclaw/dist/control-ui"
  }
}

错误表现如下图所示：

WebUI 报错截图

解决方法是手动配置 control-ui 路径。

一般安装路径如下：

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

修改 openclaw.json 文件，添加以下参数：

{
  "controlUi": {
    "root": "C:/Users/你的用户名/AppData/Roaming/npm/node_modules/openclaw/dist/control-ui"
  }
}

更多推荐文章