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 文件夹进行确认。

