ntfy 接入——轻量推送通知

这篇教程教你如何把 Hermes Agent 接到 ntfy——一个像“传呼机”一样简单的消息服务，让你用手机就能跟 AI 助手聊天，随时收到它的回复。

---

ntfy 是什么？为什么选它？

想象一下，ntfy 就是一个公共信箱。你给某个信箱起个名字（比如 hermes-myname-2026），手机装上 ntfy 应用并“订阅”这个信箱，然后任何往这个信箱里投递的消息，你的手机都会立刻收到推送。

对 Hermes 来说，这个信箱就是它的“电话线”：你发消息到信箱 → Hermes 收到并处理 → 回复再投回信箱 → 你手机弹出通知。整个过程不需要装额外软件、不需要服务器常驻，轻量又简单。

---

第 1 步：准备一个“信箱名”

随便起一个独一无二的字符串，就像给信箱贴标签。例如：hermes-myname-2026。

建议起得长一点、难猜一点（比如 hermes-7d4f9c8b-2026），因为知道信箱名的人都能给你的 AI 发消息，它相当于你的共享密码。

第 2 步：手机安装 ntfy 应用

• 在应用商店搜索 ntfy 并安装。
• 打开应用，点 + 号，输入你选好的信箱名，订阅它。

第 3 步：配置 Hermes

在服务器上打开配置文件 ~/.hermes/.env，加入以下三行：

NTFY_TOPIC=hermes-myname-2026
NTFY_ALLOWED_USERS=hermes-myname-2026
NTFY_HOME_CHANNEL=hermes-myname-2026

• NTFY_TOPIC：Hermes 要监听的“信箱”（接收消息）。
• NTFY_ALLOWED_USERS：身份白名单。ntfy 没有真正的用户系统，信箱名本身就是身份，所以这里填同一个名字即可。
• NTFY_HOME_CHANNEL：默认投递渠道，定时任务的通知也会发到这里。

保存后重启网关：

hermes gateway restart

第 4 步：开始对话！

在手机 ntfy 应用里，往这个信箱发一条消息（比如“你好”）。Hermes 会回复你，手机立刻弹出推送通知——就像跟朋友发微信一样。

---

进阶玩法

• 定时任务推送：在 Hermes 的定时任务里指定 deliver="ntfy"，它就会每小时把摘要推到你手机。
• 开启 Markdown 排版：在 .env 里加一行 NTFY_MARKDOWN=true，回复就能显示加粗、列表、代码块等格式。
• 只发不收：如果你只想要通知（比如服务器警报），不想要 AI 回复，那就不要设置 NTFY_ALLOWED_USERS，这样消息就是单向的。

注意几个“坑”

• 消息长度：ntfy 单条消息上限 4096 字符，超了 Hermes 会自动截断。
• 没有“正在输入”提示：别等它，直接发消息就行。
• 安全提醒：默认情况下，任何人知道信箱名就能给你的 AI 发指令。想要更安全，可以自建 ntfy 服务器并开启访问控制，或者使用 ntfy.sh 的付费保留主题。

遇到问题？

• 401 错误：NTFY_TOKEN 填错了，检查令牌权限后重启网关。
• 404 错误：信箱在服务器上不存在（自建服务器需手动创建）。
• 能连上但没反应：检查 NTFY_ALLOWED_USERS 是否包含信箱名——没写白名单 = 拒绝一切消息。

---

小结

ntfy 接入是 Hermes 最轻量的消息方案：一个信箱名 + 一个手机 App，就能随时随地跟你的 AI 助手对话。它适合快速体验、个人使用，或者作为定时通知的推送渠道。

下篇预告：如果觉得 ntfy 太“轻”，下一篇我们聊聊更强大的 Telegram 接入——支持富媒体、群聊、按钮交互，让你的 AI 助手拥有完整的“聊天软件”体验。敬请期待！