需启用API服务、启动本地仪表盘、配置Prometheus数据源并导入ID为18608的预置监控面板，缺一不可；否则Dashboard将报错、空白或仅显示基础运行态。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要让Hermes Agent最新桌面端Dashboard集中显示系统状态，需启用API服务、启动本地仪表盘、配置数据源并加载预置监控面板，缺一不可。直接运行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=trueAPI_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等指标可查。
第二步：在Dashboard界面右上角点击⚙️→Data Sources→Add data source→搜索Prometheus→URL填http://localhost:9090→点击Save & Test。
第三步：进入Dashboards → Import，输入面板ID 18608（专为Hermes v0.9+优化的vLLM兼容仪表板），选择刚添加的Prometheus数据源→点击Import。
导入后，主视图自动切换为四象限布局：左上显示Agent uptime与健康状态灯，右上绘制rate(hermes_pipeline_processed_total[5m])趋势，左下用Bar gauge对比各pipeline backlog，右下以Text面板列出最近三次异常事件摘要。
