求教 主控台显示服务器未启动

[XK-H]

问题描述

http://127.0.0.1:7891/ 主控台显示服务器未启动

已尝试的方案

相关环境

• OpenClaw 版本：5.12
• 操作系统：windows WSL2 Ubuntu26.04
• Python 版本：3.14

[euvre]

---

Issue #319 分析：主控台显示「服务器未启动」

问题现象

用户在 http://127.0.0.1:7891/ 打开主控台后，顶部状态栏显示 「❌ 服务器未启动」。

用户环境：

• OpenClaw 版本：5.12
• 操作系统：Windows WSL2 Ubuntu 26.04
• Python 版本：3.14

根因分析

根据代码追踪，这个错误信息的显示逻辑如下：

1. 前端检测机制

前端每 5 秒轮询 /api/live-status 接口。App.tsx 第 58-59 行：

          <span className={`chip ${syncOk ? 'ok' : syncOk === false ? 'err' : ''}`}>
            {syncOk ? '✅ 同步正常' : syncOk === false ? '❌ 服务器未启动' : '⏳ 连接中…'}

当 syncOk 为 false（即 liveStatus.syncStatus.ok === false）时显示「❌ 服务器未启动」。

2. 数据来源

/api/live-status 端点在 server.py 第 2419-2421 行：

        elif p == '/api/live-status':
            task_data_dir = get_task_data_dir()
            self.send_json(read_json(task_data_dir / 'live_status.json'))

它读取的是 live_status.json 文件。这个文件由 scripts/run_loop.sh 调用 scripts/refresh_live_data.py 定期生成（每 15 秒同步一次）。

3. 两种可能的触发情况

• 情况 A：服务器进程根本没启动。 前端 fetch('/api/live-status') 请求失败（catch 到异常），liveStatus 为 null，syncOk 为 undefined，但 store.ts 中 loadLive 的 catch 块是静默吞错的：

    } catch {
      // silently fail
    }

所以 liveStatus 保持 null，sync 为 undefined，syncOk 为 undefined，最终显示「⏳ 连接中…」而非「❌ 服务器未启动」。

• 情况 B（更可能）：服务器已启动，但 live_status.json 中 syncStatus.ok 为 false。 这意味着 data/live_status.json 文件存在但内容表明同步失败，或者该文件是空的/初始的 {}。

4. 最可能的根本原因

结合用户在 WSL2 环境和 Python 3.14 的信息，问题原因很可能是：

(a) run_loop.sh 数据刷新循环没有运行或同步失败

edict.sh 启动时会检查是否有 openclaw 命令（第 92 行），如果检测不到会跳过数据刷新循环。data/live_status.json 的初始内容可能就是 {}，没有 syncStatus 字段，或者 syncStatus.ok 为 false。

(a) 的可能子原因包括：

• 用户没有运行 install.sh 完成初始化（data/ 目录下缺少数据文件）
• openclaw CLI 没有正确安装或不在 PATH 中
• WSL2 环境下 ~/.openclaw 路径有问题
• live_status.json 是空的初始 {}，导致 syncStatus 不存在，前端读取后 sync.ok 为 undefined，转为 false

(b) Python 3.14 兼容性问题

Python 3.14 是非常新的版本（截至 2026 年 5 月仍可能是 beta/rc），dashboard/server.py 使用了 http.server、pathlib、from auth import ... 等模块。可能存在兼容性问题导致服务器启动后某些导入失败或运行时异常。

(c) WSL2 网络问题

WSL2 的网络栈与宿主机 Windows 不完全一致。如果服务器绑定在 127.0.0.1:7891，而用户从 Windows 浏览器访问 http://127.0.0.1:7891/，WSL2 的 localhost 转发可能不工作（取决于 WSL 版本和配置），导致前端无法连接到后端 API。

总结

最可能的根因是以下几点的组合：

1. 数据刷新循环（run_loop.sh）未运行，导致 data/live_status.json 中 syncStatus 字段缺失或为默认值 {}，前端解析后 syncStatus.ok 为 undefined/false，显示「服务器未启动」
2. WSL2 网络隔离可能导致浏览器无法访问 WSL2 内的 127.0.0.1:7891
3. Python 3.14 的兼容性问题可能导致服务器端某些模块导入或运行失败

建议排查步骤

1. 确认 data/live_status.json 文件的内容
2. 在 WSL2 终端内用 curl http://127.0.0.1:7891/api/live-status 检查服务器是否正常运行
3. 确认 run_loop.sh 是否在运行（ps aux | grep run_loop）
4. 如果需要从 Windows 浏览器访问，可能需要将服务器绑定到 0.0.0.0（设置 EDICT_DASHBOARD_HOST=0.0.0.0）或配置 WSL2 的端口转发