Qclaw Dashboard 实操手册：网关状态实时监控、一键重启与自动修复详解-开发者社区

Qclaw Dashboard 实操手册：网关状态实时监控、一键重启与自动修复详解

【免费下载链接】Qclaw不用命令行，小白也能轻松玩转 OpenClaw项目地址: https://gitcode.com/gh_mirrors/qc/Qclaw

Qclaw 是一款面向小白的 OpenClaw 桌面管家，无需命令行即可完成安装与配置。本文带你实操 Qclaw Dashboard 控制面板的三大核心能力：网关状态实时监控、网关一键重启（含强制重启）和网关自检自动修复，让你不用看日志也能快速恢复故障。

🧭 什么是 Qclaw Dashboard

完成环境准备后，Qclaw 会进入Dashboard（控制面板），这是日常使用 OpenClaw 的主界面。面板把最关键的运维操作做成了几个按钮：启动/重启网关、强制重启、自检修复、插件环境修复，官方将其概括为"功能面板——实时监控网关状态、一键重启、修复网关"，源码位于 README.md。

⚡ 进入控制面板前的自动状态检查

点击"进入控制面板"后，Qclaw 会先跑一遍Dashboard 引导检查流程，依次完成 4 件事：

读取配置快照— 汇总渠道与模型提供商数量；
读取网关状态— 判断网关是否运行；
读取模型状态— 失败时自动降级为"按已有配置显示"；
整理渠道配对状态— 如飞书机器人配对数、离线数。

整个过程带进度条展示，任一环节失败都会给出"重新检查 / 重新配置"两个出口，而不是直接白屏。该流程实现在 GatewayBootstrapGate.tsx，失败提示与重试按钮见 GatewayBootstrapGate.tsx。

💡 即使网关暂时未就绪，面板也会带"软警告"照常打开，方便你在面板内继续处理。

📡 网关状态实时监控：10 秒轮询 + 红绿灯徽章

控制面板顶部的"网关状态"卡片是整个 Dashboard 的"仪表盘"：

绿色圆点"运行中" / 红色圆点"已停止"：一眼判断网关是否存活；
每 10 秒自动轮询一次网关健康状态，配置每 30 秒刷新一次，无需手动操作（轮询逻辑见 Dashboard.tsx）；
卡片展开后出现 4 个操作按钮：启动/重启网关、强制重启、自检修复、插件环境修复（界面代码见 Dashboard.tsx）。

网关底层支持识别 16 种运行状态码，例如healthy（健康）、gateway_not_running（未运行）、port_conflict_foreign_process（端口被外部进程占用）、token_mismatch（令牌不匹配）等，源码定义在 gateway-runtime-state.ts，默认监听端口为 18789（见 gateway-runtime-state.ts）。

🔄 网关一键重启：重启 vs 强制重启怎么选

面板提供两档重启，操作都是点一下按钮、等待通知，全程无需终端：

按钮	适用场景	底层动作
重启网关 / 启动网关	修改配置后让它生效，或网关尚未启动	重新加载网关并等待健康检查通过（Dashboard.tsx）
强制重启	网关卡住、无响应、点重启没用	先强制结束进程再拉起，同样等待就绪确认（Dashboard.tsx）

两个按钮执行后都会自动做"就绪确认"：只有真正连上才会弹出绿色"网关已重启完成"通知，否则给出红色失败提示并附原因。悬停按钮可查看官方提示文案，如"强制重启网关，适合卡住或无响应时使用"（提示语定义见 tooltips.json）。

🔧 网关自检自动修复：一条命令恢复运行

当面板显示网关异常，优先点击"自检修复"按钮。它会自动完成"检查→修复→验证"闭环：

检查网关服务是否缺失、配置是否有效、端口是否冲突；
按问题类型执行对应恢复动作，内置 9 类动作：安装插件、安装服务、启动/重启/停止网关、迁移端口、等待就绪、运行 doctor 体检（动作定义见 gateway-runtime-state.ts）；
修复成功后立即刷新状态，弹出"检查修复完成，网关已恢复可用"（实现见 Dashboard.tsx）。