使用指南 — Hermes Box

1.1 第一次对话

在飞书私聊或群聊里找到 Hermes 机器人，发第一条消息开始。建议从简单的「自我介绍」开始，感受它的能力边界。

三种发起方式

1

私聊

飞书搜索「Hermes」或「Hermes Box」→ 进入机器人私聊。适合个人任务（简报、备忘、日程）。

2

群聊 @

在任何群里 @Hermes 加问题。适合团队协作（会议纪要、任务分配）。

3

命令触发

以 / 开头的命令（如 /help、/morning-briefing）。适合固定流程。

试试这几句话

用户: 你好，请介绍一下你自己
Hermes: 我是 Hermes，常驻在你的 Hermes Box 上。
      云端大模型做主力推理，断网时本地 NPU 量化模型自动兜底。
      我能帮你处理飞书消息 / 日历 / 文档 / 任务 / 通讯录，
      也可以安装第三方 Skills 扩展能力。

用户: 今天上海天气怎么样
Hermes: 上海今天多云 18~24°C，东风 3 级。出门带件薄外套。

用户: 帮我在日历上加个明天下午 3 点的会议，主题是「OKR 复盘」
Hermes: ✓ 已创建日历事件
      时间：明天下午 15:00-16:00
      主题：OKR 复盘
      参会人：默认（无指定）
      地点：未指定
      提醒：提前 15 分钟
      是否需要补充参会人或议程？

关于上下文

第一次建立的会话是「工作模式」，后续对话都基于这个上下文。如果想开新话题，发 /reset 重置上下文。

1.2 初始化配置

花 5 分钟配置个性化选项，让 Hermes 更懂你。所有配置都存本地 TF 卡，随时可改可重置。

基础设置

跟 Hermes 说话就行，一句话搞定：

用户: 我是产品经理张三，在上海，以后用中文回复我，晚上 10 点到早上 8 点不要打扰我
Hermes: ✓ 已记录你的偏好
        · 时区：Asia/Shanghai
        · 语言：中文
        · 称呼：张三
        · 角色：产品经理
        · 免打扰：22:00 - 08:00
        · 通知级别：仅重要

      这些配置都存在本地 TF 卡。随时可以说「修改配置」或「重置配置」。

用户: 把通知改成全部
Hermes: ✓ 已改为「全部通知」

隐私设置

Hermes 默认云端主力推理 + 本地兜底。直接跟它说你的隐私偏好：

用户: 我的所有数据都不要上云，全部在本地处理
Hermes: ✓ 已开启「本地优先」模式
        · Skills 数据：完全本地
        · 推理：本地 NPU 兜底（能力约降 30%）
        · 飞书消息：本地转发，不上传服务商

      注意：纯本地模式下，复杂任务（如跨 5 个 Skill 的会议总结）可能失败。

用户: 算了，还是允许飞书 IM 和日历上云，其他保持本地
Hermes: ✓ 已调整
        · 允许上云：飞书 IM、飞书日历
        · 保持本地：文档、任务、对话历史、Skills 配置

用户: 查一下我的隐私策略
Hermes: 当前策略：白名单模式
        · 允许上云：飞书 IM、飞书日历
        · 本地处理：文档、任务、对话、Skills
        · 推理：云端主力 + 本地兜底

模型偏好

普通用户跟 Hermes 说话就行，深度玩家可以用 SSH 调命令：

用户: 你现在用的什么模型？
Hermes: 当前配置：
        · 主推理：Claude Sonnet 4.5（云端）
        · 兜底：Hermes Nano 1.5B（本地 NPU）
        · 成本模式：标准

用户: 切换到 GPT-5
Hermes: ✓ 已切换到 GPT-5，下次对话生效。

用户: 钱包有点紧，省点用
Hermes: ✓ 已开启「成本敏感」模式
        · 简单任务：用 DeepSeek V3（便宜 80%）
        · 复杂任务：仍用 Claude Sonnet 4.5
        · 预计月费下降 ~60%

高级玩法：SSH 登录盒子直接命令

通过 SSH 登录盒子后，可用 hermes model set primary <model> 等命令直接调整。普通用户用对话即可。

1.3 第一个复杂任务

体验 Hermes 的多步执行能力。给它一个开放式问题，看它如何拆解、调用多个 Skills、汇总输出。

推荐示例：总结本周会议

用户: 总结本周所有飞书会议纪要，按项目分组，给出 3 条可执行建议

Hermes: 正在执行（预计 30-60 秒）...
      ↓ 调用 lark-doc 拉取本周会议纪要列表
      ↓ 找到 7 场会议，按项目分组：
        · Hermes Box 项目 (3 场)
        · 数据迁移 (2 场)
        · 客户演示 (2 场)
      ↓ 并行读取每场会议纪要全文
      ↓ LLM 归纳总结 + 提取待办

      ✓ 完成

      ========== 本周会议摘要 ==========
      【Hermes Box 项目】
      · 硬件：v1.0 PCB 联调通过，待开模
      · 软件：Hermes Agent v0.14.3 上线，新增多 Profile
      · 文档：使用指南 v1 重构中（按你之前要求拆分为 2 章）

      【数据迁移】
      · 旧 CRM 数据已全量导出
      · 新 CRM 字段映射 80% 完成

      【客户演示】
      · 周三 A 客户：技术认可，待商务确认
      · 周五 B 客户：需补一份对比 Demo

      ========== 3 条可执行建议 ==========
      1. 优先推动 B 客户对比 Demo（时间紧）
      2. 新 CRM 字段映射剩余 20% 拉人集中攻关
      3. 使用指南 v1 重构确认本周可交付

它怎么做到的

Hermes 自动做了 4 件事：

把"总结本周会议"拆成 3 个子任务：拉列表 → 读全文 → 归纳
并行调用 lark-doc skill 读取多份会议纪要
用云端主力模型做摘要和分组
结构化输出（按项目分组 + 可执行建议）

复杂任务会消耗较多 Token

一次会议总结大约消耗 5K-15K Token。如果每天都要跑，建议在管理员后台设置"低 Token 模式"自动降级到 8B 模型。

1.4 第一个计划任务

让 Hermes 每天早上 8:30 主动推天气 + 日历 + 待办。所有计划任务用 cron 表达式管理，存本地 SQLite。

设置一个计划任务

跟 Hermes 说「我要一个任务」就行，它会理解自然语言并帮你安排：

用户: 帮我设置一个工作日早上 8:30 的任务，推送天气 + 日历 + 待办
Hermes: ✓ 已创建「晨间简报」任务
        · 任务名：morning-briefing
        · 时间：周一至周五 08:30（北京时间）
        · 内容：天气 + 日历前 3 项 + 待办列表
        · 推送到：飞书私聊

      要先试运行一次吗？

用户: 试一下
Hermes: ✓ 1 分钟后试运行... 成功推送，内容已发到私聊。
      下周一 08:30 正式生效。

管理计划任务

所有计划任务都跟 Hermes 说话管理即可：

用户: 列出我所有计划任务
Hermes: 你的计划任务（3 个）：
        ✓ morning-briefing
          周一至周五 08:30
          上次执行：今天 08:30 ✓ 成功
        ⏸ weekly-report
          每周一 09:00（已暂停）
        ✓ backup-config
          每晚 22:00

用户: 暂停晨间简报，休假几天
Hermes: ✓ 已暂停 morning-briefing，恢复时说一声。

用户: 把 weekly-report 改成每周五 17:00
Hermes: ✓ 已更新。下次执行：本周五 17:00。

用户: 看看晨间简报最近一周的执行历史
Hermes: 最近 5 次执行：
        06-09 08:30 ✓ 推送成功（4 项）
        06-10 08:30 ✓ 推送成功（6 项）
        06-11 08:30 ✗ 网络超时（已重试）
        06-12 08:30 ✓ 推送成功（5 项）
        06-13 08:30 ✓ 推送成功（7 项）

用户: 删除 backup-config
Hermes: ✓ 已删除 backup-config 任务。

任务	cron	说明
工作日晨间简报	30 8 * * 1-5	天气 + 日历 + 邮件摘要 + 待办
每周一项目周报	0 9 * * 1	汇总上周完成 / 进行中 / 阻塞
每晚 22 点备份	0 22 * * *	自动备份 Skills 配置到 TF 卡
每月 1 号清理	0 3 1 * *	清理 90 天前的执行日志

1.5 Skills 安装与使用

Skills 是 Hermes 的能力扩展点。出厂预装 5 个飞书 Skills 覆盖日常工作流；还可以从社区安装第三方 Skills（本地工具 / 开发者 / 内容创作 / 学习 / 生活……），或者自己编写。

预装 Skills（5 个 · 飞书）

覆盖飞书消息 / 日历 / 任务 / 文档 / 通讯录，直接通过飞书对话调用。

`lark-im` · 飞书消息

发送 / 接收飞书消息，群消息 @机器人，私聊问答。

用户: @Hermes 帮我给张三发条消息：会议改到 3 点
Hermes: 已发送 ✓

`lark-calendar` · 日程管理

查询、创建、修改飞书日历事件，支持自然语言时间描述。

`lark-task` · 任务清单

同步飞书任务，支持按优先级、截止时间、负责人过滤。

`lark-doc` · 文档检索

本地索引 + 语义搜索，秒级响应百万字文档库。

`lark-contact` · 通讯录

按姓名 / 部门查找同事，支持别名（"小张" → 张三）。

安装第三方 Skills

跟 Hermes 说一句话就行。它会搜索社区仓库、列出匹配项、引导你完成安装和启用。下面是几个真实会装到的场景，覆盖本地工具 / 开发者 / 内容创作 / 学习 / 生活：

用户: 帮我装一个本地备份的 skill
Hermes: 找到 1 个：local-backup v1.2.0（官方）
        自动备份 Skills 配置和对话记录到 TF 卡
      装吗？
      用户: 装
      Hermes: ✓ 安装完成，需要重启 Hermes Agent 进程。重启吗？
      用户: 重启
      Hermes: ✓ 重启成功。local-backup 已生效。

用户: 找找看能不能自动写周报
Hermes: 找到 1 个：weekly-report v1.4.2（社区）
        汇总本周会议 / 任务 / PR，生成结构化周报
      装吗？
      用户: 装
      Hermes: ✓ 安装完成。可以用「生成本周周报」调用。

用户: 装一个能搜本地代码的
Hermes: 找到 1 个：code-search v0.9.0（官方）
        语义搜索本地 git 仓库
      装吗？
      用户: 装
      Hermes: ✓ 安装完成。可以用「在 ~/projects 里搜: <关键词>」调用。

用户: 卸了 weekly-report，我不需要了
Hermes: ✓ 已卸载。

用户: 还有哪些好玩的？推荐 3 个
Hermes: 推荐 3 个：
        · paper-summarizer v2.1.0（社区）
          arXiv 论文本地摘要，输出 Markdown 笔记
        · rss-digest v1.0.3（社区）
          订阅 RSS / Atom 源，每早汇总到飞书
        · video-summarizer v0.6.0（社区）
          本地视频转写 + 关键片段摘要
      要装哪个？

用户: 装 paper-summarizer
Hermes: ✓ 安装完成。可以用「总结这篇论文: <本地 pdf 路径>」调用。

用户: 列出我装的所有 skill
Hermes: 已安装（9 个）：
        · 5 个预装（lark-im / calendar / task / doc / contact）
        · local-backup v1.2.0
        · code-search v0.9.0
        · paper-summarizer v2.1.0

批量部署 / 自动化怎么办？

对话方式适合日常零散安装。批量部署、CI/CD 等自动化场景，可以通过 SSH 用 hermes skill install <name> 命令直接装。

编写自己的 Skill

Skill 本质是一个符合 agentskills.io 规范的 Markdown 文件，包含：

YAML frontmatter：name / description / tools / triggers
系统提示词：告诉 Hermes 这个 Skill 是做什么的
工具调用说明：需要调用哪些 API / 命令
示例对话：3-5 个用户 → Hermes 的典型交互

# my-skill/SKILL.md
---
name: paper-clip
description: 把今天 ~/Downloads 下的 PDF 论文自动归档到 ~/Papers/<月份>/<作者>-<年份>.pdf
version: 1.0.0
author: your-name
triggers:
  - schedule: "0 22 * * *"
    action: archive
tools:
  - file.move
  - pdf.read_metadata
---

# Paper Clip

每天 22:00 自动把 ~/Downloads 下 24 小时内新增的 .pdf 论文归档到 ~/Papers/<月份>/。

## 行为
1. 扫描 ~/Downloads 下 24h 内新增的 .pdf
2. 读取 PDF 元数据（标题 / 作者 / 年份）
3. 创建 ~/Papers/<月份>/（如果不存在）
4. 重命名为 <作者>-<年份>.pdf 并移动

## 示例对话
- 用户：「把今天下载的论文归档」
- 用户：「~/Papers 现在有什么」

写完后放到 ~/.hermes/skills/my-skill/SKILL.md，跟 Hermes 说「重载 skills」即可生效。

1.6 常见问题

关于 Hermes Agent 软件使用的高频问题。

Q: Hermes 会记住我说的话吗？

A: 会的。当前会话的上下文会一直保留到 /reset 或会话超时（默认 30 分钟）。跨会话的"长期记忆"由 Hermes 自动提取（基于你标记「有用」的执行轨迹），存到本地。

Q: 数据会上云吗？

A: 默认配置下，配置 / 缓存 / 对话记录 / Skills 状态 都存在本地 TF 卡。只有调用云端大模型时，对话内容会上传到模型服务商。你可以跟 Hermes 说"所有数据都不要上云"，让它把 Skills 全部跑在本地（能力会下降约 30%）。

Q: 可以换大模型吗？

A: 可以。Hermes 支持 OpenAI 兼容协议，hermes model set primary <model-name> 即可切换。推荐 Claude Sonnet 4.5 / GPT-5 / DeepSeek V3。

Q: 我自己写的 Skill 安全吗？

A: Skill 默认跑在本地沙箱里，文件系统和网络访问有白名单。详见 Skill 安全模型。

Q: 多个飞书账号能同时用一个盒子吗？

A: 可以。在管理员后台「用户管理」添加多个飞书用户授权。 v2 起支持按用户设置不同 Skills 权限。

Q: 怎么升级 Hermes Agent 版本？

A: 跟 Hermes 说"检查更新"即可：

用户: 检查更新
Hermes: 发现新版本 v0.15.0（你当前 v0.14.3）
      更新内容：
        · 新增 lark-task skill
        · 修复偶发消息丢失问题
        · 性能优化，启动速度 +20%
      要现在升级吗？

用户: 升
Hermes: ✓ 升级中...（预计 2 分钟）... ✓ 升级完成，已自动重启。

也可以用管理员后台「系统升级」一键升级，命令行 hermes upgrade 仅推荐给自动化部署场景。

1.7 故障排查

Hermes Agent 使用过程中的常见问题排查。

症状：Hermes 收到消息但不回复

可能原因：

Hermes Agent 进程挂了（看盒子 LED 状态）
云端大模型 API 限流 / 余额不足
本地 NPU 兜底模型也挂了（极端情况）

先试对话式排查：

用户: 你还活着吗？
Hermes: ✓ Hermes Agent v0.14.3 在运行
        · 进程：运行中（PID 1234）
        · 云端主推理：✓ 正常
        · 本地兜底：✓ 正常
        · Skills：5/5 在线
        · 最近 1h 处理：12 任务，0 失败

      一切正常。如果你收到了未回复的消息，可能是网络延迟或对方账号问题。

用户: 强制重启一下
Hermes: ✓ 正在重启 Hermes Agent... 10 秒后恢复。

如果对话式无响应（说明进程真挂了），用 SSH 登录盒子：hermes restart 或长按 reset 孔 5 秒。

症状：Hermes 回复很慢（>30 秒）

可能原因：

云端大模型响应慢（服务商侧问题）
任务太复杂，触发了多步执行
WiFi 信号弱

解决：

查看 hermes logs 中每步耗时
把任务拆小一点
检查 WiFi 信号（管理员后台）

症状：Skill 调用失败（提示 Permission denied）

可能原因：

飞书 token 过期
Skill 权限范围不够
用户没授权该 Skill

解决：

hermes auth refresh 刷新飞书 token
管理员后台「用户管理」检查权限
重新绑定飞书（参考 2.3）

症状：计划任务没按时执行

可能原因：

时区配置错了
盒子当时离线 / 断电
任务被 pause 了

解决：

hermes cron list 确认任务状态
hermes cron history <id> 查看执行历史
检查 hermes config get timezone

症状：升级后 Skills 全没了

可能原因： 升级过程清理了 ~/.hermes/skills/ 目录。

解决： hermes skill restore 从备份恢复（系统每晚自动备份）。如果备份也没了，需要重新安装。

还是没解决？

执行 hermes diag --pack 生成脱敏诊断包，发到 support@hermes.box。诊断包不包含对话内容，只包含系统状态、配置、错误日志。

2.1 开箱与检查

Hermes Box 采用极简包装，拆开后应当看到以下物件。

包装清单

Hermes Box 主机 × 1
USB Type-C 数据线 × 1（供电用）
5V/2A 电源适配器 × 1
预烧录的 TF 卡（已插入设备） × 1
快速配置卡 × 1（含 setup_code 和二维码）
保修卡 × 1

快速配置卡请妥善保管

卡上的 setup_code 是首次配网密码。忘记管理员密码时，它也是恢复配网的关键凭据。

外观检查

1

检查外壳

3D 打印外壳如有明显破损、裂纹，请联系售后更换。散热孔位应保持通畅。

2

确认 TF 卡到位

侧面的 TF 卡槽应有一张卡完全插入，按压可弹出。出厂时卡已烧录好系统，无需格式化。

3

找到 Type-C 接口

主机侧面有一个 USB Type-C 接口（供电用），背面有 reset 孔（长按 5 秒恢复出厂）。

2.2 上电与首次配网

接通电源后，盒子会启动并广播一个名为 Hermes-Box-XXXX 的 WiFi 热点。用手机连上这个热点就能进入配网页面。

步骤

1

接通电源

用 USB Type-C 数据线连接盒子和 5V/2A 电源适配器。启动后，侧面 LED 会先红后绿，表示系统就绪。

2

连接 Hermes-Box-XXXX 热点

打开手机 WiFi 设置，找到以 Hermes-Box- 开头的热点（XXXX 是设备 ID 后 4 位）。首次连接不需要密码。

3

浏览器自动弹出配网页

连上热点后，手机通常会自动弹出 captive portal（无密码的登录页）。如果没有弹出，手动打开浏览器访问 http://192.168.4.1。

4

输入 setup_code 并选择家庭 WiFi

输入快速配置卡上的 setup_code（8 位字母数字），选择你的家庭 WiFi 并输入密码。盒子会记住这个 WiFi 并自动连接。

5

等待连接成功

大约 30 秒后，配网页会显示「配网成功」。此时手机可以重新连回家庭 WiFi，盒子会保持在线。

只支持 2.4GHz WiFi

盒子只支持 2.4GHz 频段（穿墙能力强，IoT 通用）。如果你家里是 5GHz-only 路由器，需要开启双频合一。

2.3 飞书绑定

配网成功后，盒子会在飞书里以「机器人」身份出现。扫码即可把它加入群聊或私聊。

绑定流程

1

登录飞书管理后台

用盒子配网时填的管理员账号登录飞书开放平台。

2

扫码添加 Hermes 机器人

配网成功后页面会显示一个二维码。用飞书 App 扫描即可添加 Hermes 机器人。

3

授权 Skills 权限范围

根据需要授权 Hermes 访问的飞书资源（消息 / 日历 / 文档 / 任务 / 通讯录）。权限可随时在飞书管理后台调整。

4

绑定完成，私聊 Hermes 试试

在飞书搜索「Hermes」或「Hermes Box」找到机器人，发一条消息测试连接是否正常。

微信绑定（v1.1+）

v1.1 固件起支持微信公众号 / 企业微信绑定。详见 [升级日志](#) 或 GitHub Releases。

2.4 管理员后台

管理员后台是盒子的「控制面板」——查看设备状态、管理 Skills、配置 WiFi、查看日志都在这里。

访问方式

浏览器访问 http://hermes-box.local 即可进入管理员后台（http://hermes-box.local/skills 是后台下的 Skills 商店）。需要用 setup_code 登录。

主要功能

设备状态：CPU / 内存 / 存储 / WiFi 信号 / LED 状态
Skills 管理：浏览、搜索、安装、卸载、配置 Skills
网络配置：切换 WiFi、查看 IP、配置静态 IP
用户管理：添加 / 删除飞书用户授权
日志查看：实时查看 Hermes 任务执行日志
备份 / 恢复：导出配置 / 从备份恢复
恢复出厂：清空所有配置（v1 可长按背面 reset 孔 5 秒；v2+ 在后台也能一键恢复）

LED 状态指示

颜色	状态	含义
红（常亮）	启动中	系统正在启动
绿（常亮）	正常运行	Hermes Agent 在线
绿（闪烁）	任务执行中	正在处理任务
黄（闪烁）	警告	磁盘空间不足 / WiFi 信号弱
红（闪烁）	错误	系统异常，查看后台日志

Hermes Agent 上手指南

1.1 第一次对话

三种发起方式

试试这几句话

1.2 初始化配置

基础设置

隐私设置

模型偏好

1.3 第一个复杂任务

推荐示例：总结本周会议

它怎么做到的

1.4 第一个计划任务

设置一个计划任务

管理计划任务

推荐起步计划任务

1.5 Skills 安装与使用

预装 Skills（5 个 · 飞书）

lark-im · 飞书消息

lark-calendar · 日程管理

lark-task · 任务清单

lark-doc · 文档检索

lark-contact · 通讯录

安装第三方 Skills

编写自己的 Skill

1.6 常见问题

Q: Hermes 会记住我说的话吗？

Q: 数据会上云吗？

Q: 可以换大模型吗？

Q: 我自己写的 Skill 安全吗？

Q: 多个飞书账号能同时用一个盒子吗？

Q: 怎么升级 Hermes Agent 版本？

1.7 故障排查

症状：Hermes 收到消息但不回复

症状：Hermes 回复很慢（>30 秒）

症状：Skill 调用失败（提示 Permission denied）

症状：计划任务没按时执行

症状：升级后 Skills 全没了

Hermes Box 首次开箱

2.1 开箱与检查

包装清单

外观检查

2.2 上电与首次配网

步骤

2.3 飞书绑定

绑定流程

2.4 管理员后台

访问方式

主要功能

LED 状态指示

`lark-im` · 飞书消息

`lark-calendar` · 日程管理

`lark-task` · 任务清单

`lark-doc` · 文档检索

`lark-contact` · 通讯录