openclaw webUI 空白页问题
部分使用Win10安装OpenClaw,启动WebUI时显示Not Found的解决方案
最近,不少在Windows 10上尝鲜OpenClaw的朋友遇到了一个典型问题:启动WebUI界面后,浏览器里空空如也,只显示一个冷冰冰的“Not Found”。这多半是因为你通过pnpm或npm进行的安装,系统没有正确识别到WebUI的静态文件路径。好在,新版本已经修复了这个bug,但如果你不幸“中招”,也别着急,手动配置一下就能轻松搞定。
问题现象
启动后,本该出现的图形化操作界面不见了,取而代之的是一个简单的“Not Found”错误页面,如下图所示:
这感觉就像找到了控制室,却发现操作台不见了,确实让人有点摸不着头脑。
核心原因与解决办法
问题的根源在于,安装程序有时没能自动配置好WebUI前端文件的存放路径。解决思路很直接:我们手动告诉系统文件在哪里就行了。
首先,你需要找到control-ui这个文件夹。通常情况下,它会乖乖待在以下这个路径里:
C:\Users\你的用户名\AppData\Roaming\npm\node_modules\openclaw\dist\control-ui
请务必把上面路径中的“你的用户名”替换成你自己电脑的实际用户名。找到这个路径,就成功了一半。
接下来,是关键的一步:修改OpenClaw的配置文件。你需要打开openclaw.json文件,然后在其中添加一个专门的配置项,来指明前端资源的根目录。
具体来说,在配置文件里加入下面这段参数(记得把路径中的“86135”也换成你自己的用户名):
{“controlUi”: {“root”: “C:/Users/86135/AppData/Roaming/npm/node_modules/openclaw/dist/control-ui”},}
这里有个细节需要注意:Windows系统路径中的反斜杠“\”在JSON文件里需要改为正斜杠“/”,否则可能导致解析错误。添加上面这行配置,本质上就是为OpenClaw绘制了一张精确的“藏宝图”,让它能顺利找到并加载所有界面文件。
完成配置文件的修改并保存后,重启OpenClaw服务。再次打开WebUI地址,熟悉的操作界面应该就会跃然屏上了。这个办法虽然简单,但胜在有效,能帮你快速绕过这个小坑,继续专注于更有趣的探索。
