本页目录
第 7 章 日常维护
装好以后,平时要做的几件事:看它在不在跑、更新、出问题看日志、看用了多少额度、备份。都在普通终端里做。
7.1 看它在不在跑
终端运行:
hermes status
能看到用的模型(deepseek-flash)、模型服务商(DeepSeek)、Gateway: ✓ running(后台网关在运行)、接的平台(Feishu / Lark),以及定时任务有几个在用。

Gateway 不是 running 的,飞书里的机器人就不会回。运行 hermes gateway restart 重启它;每次开机后都要手动启动的,回到第 2.5 节设开机自动启动。
7.2 更新
第 1 步:看有没有新版。 终端运行:
hermes --version
hermes update --check
第一行是当前版本(下图是 v0.23.0)。下面出现 Update available 和 Selected release available: stable v0.23.1,就是有新的正式版。

第 2 步:更新。 在同一个窗口里运行:
hermes update
它会先暂停后台网关,从第 1 章安装时设的国内镜像取新版本,更新依赖和配置,最后重启网关。实测从 v0.23.0 升到 v0.23.1 用了约 7 分钟,中途没有要回答的问题。看到 Update complete! (v0.23.0 → v0.23.1),最后一行 default (pid …) @ … - up to date,就更新好了。

几点说明:
- 更新期间网关是停着的,这几分钟里飞书机器人不回消息。更新完在飞书里问它一句“你现在是哪个版本”,它答出新版本号,就说明网关正常。
- 中间有一行
Windows cua-driver refresh deferred (autostart registration requires UAC),说的是“操作电脑”工具的组件。本教程没有用这个工具,可以不管。 - 官方文档说,更新前它会自动存一份关键设置的快照。想更稳妥,更新前先照 7.5 节做一次备份。
7.3 出问题先看日志
机器人不回、定时任务没发、某个命令报错,先看日志。终端运行:
hermes logs list
hermes logs errors -n 3
第一行列出所有日志文件和大小;第二行看错误日志最后 3 条。要看网关的运行记录,用 hermes logs gateway -n 50(最后 50 行)。

上图这几条都不用处理:
WARNING … No env user allowlists configured:没有另设允许名单,按第 2.4 节的配对规则只认你。每次网关启动都会出现。ERROR Lark: receive message loop exit … sent 1000 (OK); then received 1000 (OK):网关重启时和飞书的长连接正常断开。
要找的是出问题那个时间点前后的记录。🤖 看不懂的,把那几行连同你做了什么一起交给智能体。日志里有对话编号等信息,不要贴到公开的地方。
7.4 看用了多少额度
终端运行(7 是最近几天,可以改):
hermes insights --days 7
Overview 里是对话段数、消息数、工具调用次数和用掉的 token;Cost 里的 Estimated 是估算花费。实测两天里 13 段对话,估算约 0.05 美元;Unknown: 2 session(s) (no pricing data) 表示有两段对话没有价格数据,没有算进去。往下翻还有按平台的统计:实测时定时任务(cron)跑了 5 次,也在用额度。

这个花费是 Hermes 自己估算的,实际扣了多少以 DeepSeek 开放平台的账单为准。每条消息、每次定时任务运行都在用额度,定时任务的频率按需要定,用不着的及时暂停(第 5.4 节)。
7.5 备份
终端运行:
hermes backup
几秒后显示 Backup complete: C:\Users\你的用户名\hermes-backup-日期-时间.zip。实测打包了 450 个文件,11.7 MB 压缩到 2.6 MB。程序本身、缓存和快照不打包(Excluded directories 列出的那些)。

- 备份里有配置、技能、记忆、对话记录、定时任务,还有
.env:API Key 和 App Secret 都在里面。像保管密码一样保管它,不传到共享网盘,不发给别人。 - 同一个文件夹里默认只保留最近 3 份完整备份,更早的会被删掉。
- 恢复用
hermes import 备份文件名.zip,本教程没有实测恢复。
官方文档:Updating & Uninstalling。
✅ 自查
hermes status显示Gateway: ✓ runninghermes update --check能看到当前版本和有没有新版hermes insights能看到估算花费- 用户文件夹里有一个
hermes-backup-….zip