openclaw webUI 空白页问题

2026-05-05阅读 0热度 0
AIGC 运维

部分使用Win10安装OpenClaw,启动WebUI时显示Not Found的解决方案

最近,不少在Windows 10上尝鲜OpenClaw的朋友遇到了一个典型问题:启动WebUI界面后,浏览器里空空如也,只显示一个冷冰冰的“Not Found”。这多半是因为你通过pnpm或npm进行的安装,系统没有正确识别到WebUI的静态文件路径。好在,新版本已经修复了这个bug,但如果你不幸“中招”,也别着急,手动配置一下就能轻松搞定。

问题现象

启动后,本该出现的图形化操作界面不见了,取而代之的是一个简单的“Not Found”错误页面,如下图所示:

WebUI界面显示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地址,熟悉的操作界面应该就会跃然屏上了。这个办法虽然简单,但胜在有效,能帮你快速绕过这个小坑,继续专注于更有趣的探索。

免责声明

本网站新闻资讯均来自公开渠道,力求准确但不保证绝对无误,内容观点仅代表作者本人,与本站无关。若涉及侵权,请联系我们处理。本站保留对声明的修改权,最终解释权归本站所有。

相关阅读

更多
欢迎回来 登录或注册后,可保存提示词和历史记录
登录后可同步收藏、历史记录和常用模板
注册即表示同意服务条款与隐私政策