想要让 Hermes Agent 最新桌面端 Dashboard 集中显示系统状态，可不是简单敲个命令就完事的。你需要依次完成四个关键步骤：启用 API 服务、启动本地仪表盘、配置 Prometheus 数据源、导入编号为 18608 的预置监控面板——缺一不可。否则 Dashboard 要么报错，要么一片空白，最多只能看到基础运行状态凑合使用。

直接运行 hermes dashboard 会遇到阻碍，因为默认状态下 API 没有暴露，Web UI 依赖也尚未安装。我们从根源入手，按步骤逐步推进。

启用 API 服务并设置密钥

桌面端 Dashboard 全靠 HTTP API 提供实时数据，因此必须首先启动网关服务，并设置一个强度足够的密钥，否则连接会直接失败，或者返回 401 错误让你束手无策。

以管理员身份打开 PowerShell，先把工具升级到 v0.9.0 及以上版本，执行命令：pip install --upgrade hermes-agent

接着编辑 .env 文件——该文件通常位于 ~/.hermes/ 或项目根目录下。在文件末尾添加两行配置：

【API_SERVER_KEY 必须超过 8 个字符，否则服务拒绝启动】

API_SERVER_ENABLED=true
API_SERVER_KEY=yourSecureKey2026!

密钥不要设置得太简单，否则安全性和稳定性都无法保障。

启动 Dashboard 服务

仍在 PowerShell 中，运行命令启动 API 网关：hermes gateway run -vv

当终端输出 API server listening on http://127.0.0.1:8642 时，说明网关已成功运行。注意，这个窗口不能关闭——关闭即断开连接。

再打开一个新的 PowerShell 窗口，安装 Web UI 依赖：pip install hermes-agent[web]

然后执行 hermes dashboard，耐心等待片刻，直到终端提示类似 Dashboard ready at http://127.0.0.1:3000 的信息。

使用浏览器访问该地址。首次加载可能需要等待约 30 秒——不要着急，它正在拉取内存状态、活跃会话数、最近 5 分钟错误率等核心指标。首次加载完成后，后续运行就会顺畅许多。

配置 Prometheus 数据源并导入监控面板

桌面端 Dashboard 默认只显示基础运行状态，要想集中查看 CPU、内存、Pipeline 延迟等系统级指标，必须借助 Prometheus。

第一步：确认 Prometheus 已经抓取到 Hermes 指标。访问 http://localhost:9090/targets，查看 hermes-agent 任务状态是否为 UP，同时搜索 vllm_request_success_total 等指标能否查到——如果查不到，说明数据未进入 Prometheus，后续面板将无法生效。

第二步：在 Dashboard 界面右上角点击 ⚙️ → Data Sources → Add data source → 搜索 Prometheus → URL 栏填写 http://localhost:9090 → 点击 Save & Test。测试通过即配置完成。

第三步：进入 Dashboards → Import，输入面板 ID 18608——这是专为 Hermes v0.9+ 优化的 vLLM 兼容仪表板，选择刚配置的 Prometheus 数据源，点击 Import。

导入后，主视图会瞬间变为四象限布局：左上角显示 Agent 运行时长与健康状态指示灯，右上角绘制 rate(hermes_pipeline_processed_total[5m]) 趋势图，左下角用条形图对比各 Pipeline 的积压情况，右下角通过 Text 面板列出最近三次异常事件摘要。所有关键信息一目了然，工作效率直接拉满。