Hermes高阶技巧｜🎛️ 打开Hermes驾驶舱：Web Dashboard 入门指南

一句话解决：每次改配置都要翻YAML文件，运行状态全靠猜？Dashboard让你在浏览器里一目了然。

背景：小张的烦恼

小张刚刚装好Hermes Agent，兴致勃勃地想试试。但他盯着终端窗口，面对着一堆命令和YAML配置文件犯了愁：

“环境变量配好了吗？API密钥在哪设置？Agent现在在工作吗？“

以前改个配置，要打开 ~/.hermes/config.yaml，找到对应的字段，小心翼翼地改，然后重启Agent。更别说想看看Agent在干什么——只能靠 tail -f 日志，像大海捞针。

“能不能有个图形界面啊？“

答案是：有！而且只要一个命令。

一键起飞

打开终端，输入：

1	hermes dashboard

回车之后，浏览器自动弹开，一个干净清爽的控制台出现在你面前。

[插图：Dashboard首页布局Mockup]

┌──────────────────────────────────────────────────────────┐
│  🔍 Hermes Dashboard       状态: 🟢 运行中  v0.2.7      │
├──────────────────────────────────────────────────────────┤
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────────┐│
│ │ 版本      │ │ 网关      │ │ 活跃会话  │ │ 技能数       ││
│ │ v0.2.7   │ │ connected│ │ 3个      │ │ 24个        ││
│ └──────────┘ └──────────┘ └──────────┘ └──────────────┘│
│                                                         │
│ [对话] [配置] [密钥] [会话] [日志] [分析] [Cron] [技能]  │
│                                                         │
│ ┌────────────────────────────────────────────────────┐  │
│ │  💬 最新会话                                      │  │
│ │  ┌──────────────────────────────────────────────┐ │  │
│ │  │ 用户: 帮我写一封邮件给客户...                 │ │  │
│ │  │ Agent: 好的，我来起草这封邮件...              │ │  │
│ │  │ ...                                          │ │  │
│ │  └──────────────────────────────────────────────┘ │  │
│ └────────────────────────────────────────────────────┘  │
└──────────────────────────────────────────────────────────┘

是不是很像汽车驾驶舱？所有重要的信息都在眼前。

默认端口是 9119，数据只绑定在本机（127.0.0.1），所以不用担心安全——只有你能访问。如果想换个端口：

1	hermes dashboard --port 8080

状态一眼看穿

控制台顶部有四个小卡片，实时刷新：

卡片	告诉你	怎么用
🟢 版本	当前Hermes版本号	检查是否需要升级
🔗 网关	Agent和网关的连接状态	连不上？看一下网络
💬 活跃会话	当前正在进行的对话数	>0 说明Agent正在工作
🧩 技能数	已安装的技能数量	技能太多？该清理了

小贴士：面板每5秒自动刷新，你什么都不用点。

小张看到活跃会话数是3，心想：”哦！说明我的Agent正在处理三个任务，看起来一切正常。“

[插图：状态面板特写]

┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────────────┐
│  🟢 v0.2.7│  │ 🔗 已连接 │  │ 💬 3个会话│  │ 🧩 24个技能  │
│  版本      │  │ 网关     │  │ 活跃中   │  │ 已安装       │
│  最新版 ✓  │  │ 正常     │  │ 现在工作  │  │ 查看详情 →  │
└──────────┘  └──────────┘  └──────────┘  └──────────────┘

改配置不用翻YAML

小张想改一下API密钥。以前他要：

打开 ~/.hermes/config.yaml
找到 api_keys: 那一节
手动编辑
保存
重启Hermes Agent

现在呢？

点一下顶部的 [密钥] 标签页，所有的环境变量都列在这里了：

[插图：API密钥管理面板Mockup]

┌──────────────────────────────────────────────────────────┐
│  🔑 API 密钥管理                                        │
├──────────────────────────────────────────────────────────┤
│  ├─ OPENAI_API_KEY    *********k3R   [查看] [编辑] [删除]│
│  ├─ CLAUDE_API_KEY   *********aB7   [查看] [编辑] [删除]│
│  ├─ SERP_API_KEY     *********9pQ   [查看] [编辑] [删除]│
│  └─ [ + 添加新密钥 ]                                     │
│                                                         │
│  ┌──────────────────────────────────────────────────┐   │
│  │ 💡 密钥以组为单位管理，支持.env文件导入。         │   │
│  │    改完点保存，再用 /reload 即刻生效。            │   │
│  └──────────────────────────────────────────────────┘   │
└──────────────────────────────────────────────────────────┘

点 [编辑] 修改，点 [保存]，然后输入：

/reload

不用重启！不用关掉正在运行的对话！ 密钥立刻生效。

小张长舒一口气：”终于不用每次改个密钥都重启了。“

配置面板里还有150多个字段可以调整，全都分好类别，有下拉框、开关、文本输入，不用再手写YAML了。比如：

“我想把模型改成 Claude”
→ 点[配置] → 找到 chat.model → 下拉选择 claude-sonnet-4 → 保存

历史会话随便翻

Agent干了一天的活，小张想回顾一下：”上周有个写代码的会话，当时它帮我写了个Python脚本，我想找出来看看。“

点 [会话] 标签页，搜索框输入：

写代码 上周

[插图：会话搜索界面Mockup]

┌──────────────────────────────────────────────────────────┐
│  📋 会话浏览                    [🔍 写代码 上周  ]      │
├──────────────────────────────────────────────────────────┤
│  找到 3 个结果：                                         │
│                                                         │
│  ├─ 📝 帮我写一个Python脚本...     (2026-05-21)          │
│  │   ├─ 用户: 帮我写一个Python脚本来批量重命名文件       │
│  │   ├─ Agent: 好的，我来实现这个批处理脚本...           │
│  │   └─ [工具调用: write_file] ✓ Python脚本已写入          │
│  │                                                       │
│  ├─ 🐍 Python数据处理...            (2026-05-20)          │
│  └─ 💻 Shell脚本自动化...           (2026-05-19)          │
└──────────────────────────────────────────────────────────┘

Hermes用的是全文搜索（FTS5），所以输入关键词就能找到相关的所有会话。点进去还能展开对话树，看到Agent用了哪些工具，调用是否成功。

小技巧：用角色颜色标记快速区分——蓝色是用户，绿色是Agent，灰色是工具调用的内部信息。

日志不用 tail 了

“Agent刚才好像报了个错？“ 放在以前，小张得在终端里 tail -f ~/.hermes/logs/agent.log，然后在一堆滚动文字里找红色的错误信息。

现在点 [日志] 标签页：

[插图：日志面板Mockup]

┌──────────────────────────────────────────────────────────┐
│  📜 实时日志           [🔄 自动刷新] [ERROR] [WARN] [ALL]│
├──────────────────────────────────────────────────────────┤
│  ❌ ERROR  10:32:15  调用API超时，重试第2次...             │
│  ⚠️ WARN   10:32:10  速率限制接近阈值 (85%)              │
│  ✅ INFO   10:31:55  会话 s_abc123 已创建                │
│  ✅ INFO   10:31:50  技能 `email_composer` 加载成功       │
│  ⚠️ WARN   10:31:30  磁盘空间剩余 15%                    │
└──────────────────────────────────────────────────────────┘

颜色编码：

🔴 ERROR → 出错了，需要关注
🟡 WARN → 需要注意但问题不大
🟢 INFO → 正常运行信息

还可以按级别过滤（只看ERROR或WARN），或者按组件过滤（只看和api相关的日志）。实时刷新，自动滚动。

费用一目了然

小张的老板问：”我们这周花了多少API费用？“

点 [分析] 标签页，选择 7天：

[插图：分析面板Mockup]

┌──────────────────────────────────────────────────────────┐
│  📊 用量分析                       [7天] [30天] [90天]  │
├──────────────────────────────────────────────────────────┤
│  总费用: $12.45            日均: $1.78                    │
│                                                         │
│  💰 每日Token消耗 (柱状图)                               │
│  Mon  ████████████  120K tokens  $2.10                  │
│  Tue  ███████████   105K tokens  $1.85                  │
│  Wed  █████████████ 140K tokens  $2.45  ← 峰值           │
│  Thu  ██████████     95K tokens  $1.66                  │
│  Fri  ██████████████ 150K tokens  $2.63  ← 峰值           │
│  Sat  ██████         60K tokens  $1.05                  │
│  Sun  ████████       80K tokens  $1.40                  │
│                                                         │
│  按模型分解:                                            │
│  GPT-4o:    $6.80 (55%)                                 │
│  Claude:    $4.25 (34%)                                 │
│  其他:      $1.40 (11%)                                 │
└──────────────────────────────────────────────────────────┘

“原来GPT-4o占了一半以上的费用啊，要不要考虑换成Claude？“ 有了数据分析，决策就有了依据。

常见问题

Q：Dashboard安全吗？会被别人访问吗？

A：默认只绑定 127.0.0.1（本机地址），只有你能访问。如果要让局域网其他人访问，可以用 --host 0.0.0.0，此时会自动启用OAuth登录认证（类似用微信扫码登录那种方式）。

Q：我改完配置忘了保存就关了浏览器怎么办？

A：配置修改后需要点击”保存”按钮才会写入文件。如果没保存就关闭浏览器，修改不会生效——但你可以在下次打开时重新设置。不过一般不用担心，大部分配置你设置一次就不用再动了。

Q：Dashboard占用资源多吗？

A：不多。Dashboard是一个轻量级的FastAPI服务，内存占用大约 50-100MB。你可以在需要时启动，用完关掉。如果你希望一直开着做监控，它也不会给你的机器带来明显负担。

Q：我能在手机上访问Dashboard吗？

A：当然！如果你的Hermes运行在服务器上，用 --host 0.0.0.0 启动后，手机浏览器访问 http://服务器IP:9119 就能看到。界面是响应式设计的，手机上也适配得很好。

总结

以前	现在
编辑YAML配置文件	浏览器里点几下
tail -f 看日志	颜色编码的实时日志面板
记不住CLI命令	图形界面点一点
重启才能生效	/reload 即刻生效
费用只能猜	Analytics面板一目了然