OpenClaw 启动后 Web 控制面板返回 Not Found 错误排查

问题描述

在 1.19 服务器上安装 OpenClaw 后，Web 控制面板无法登录。无论是通过浏览器访问还是使用 curl 命令，均返回 Not Found 错误。相比之下，1.12 服务器无此问题。

curl http://localhost:18789
# 返回：Not Found

排查过程

查看绑定情况

检查网关绑定配置：

openclaw config get gateway.bind
# 输出：loopback

绑定到 LAN

打开网络连通性，将绑定修改为 lan：

openclaw config set gateway.bind lan

重启网关服务：

openclaw gateway restart

设备列表和配对

配置设备对：

openclaw devices list

批准设备：

openclaw devices approve

上述操作无效。

检查 npm 版本

当前版本：

npm -v
# 11.3.0

升级到 11.11：

npm install -g [email protected]

重新构建项目。

使用 pnpm 重装

pnpm store prune
rm -rf node_modules
pnpm install

问题依旧。

使用 npm 重装

npm i -g openclaw openclaw onboard

问题依旧。

卸载并重装

执行卸载命令：

openclaw uninstall

确认卸载组件（Gateway service, State + config, Workspace），完成后 CLI 仍保留。

重新安装一遍后，问题仍未解决。

解决方案

最终通过安装 openclaw-cn 版本解决了该问题。