六维教程

Hermes 消息网关

消息网关(Gateway)让 Hermes 走出终端,常驻在各类聊天软件里,实现「手机发一句,后台跑任务,结果推回来」。本篇讲清怎么接、接哪些。

网关是什么

网关是 Hermes 的一个常驻服务,负责把外部平台的消息接进来,再把回复推回去。有了它,你不必守着电脑,在 Telegram、飞书等软件里就能随时召唤 Hermes。

快速启动

hermes gateway          # 启动网关(前台)
hermes gateway setup    # 交互式配置各平台凭据
hermes gateway start    # 以服务方式启动

首次接某个平台,先 hermes gateway setup,按提示填入该平台的 Bot Token 等信息,再启动网关。

支持哪些平台

官方文档中,网关原生对接的 IM/消息平台包括:

  • Telegram、Discord、Slack、WhatsApp、Signal
  • Email、Home Assistant、Teams

另外,在定时任务与网关的「投递目标(delivery target)」里,还支持国内常见平台:飞书、钉钉、企业微信、微信、QQ(以 feishudingtalkwecomweixinqqbot 等标识)。所以如果你主要在国内的协作工具里使用,这些也是可用的。

说明:部分旧资料把微信/QQ 等列为「需自行 webhook 接入」,实际官方投递目标已包含它们。若某平台在你版本里未直接支持,仍可用自定义 webhook 兜底。

多端值守示例

假设你在 hermes gateway setup 里同时开了 Telegram 和飞书:

  • 上班时在飞书里发「汇总今天的报错日志」。
  • 下班路上在 Telegram 里发「明早 9 点前给我日报」。
  • Hermes 都在后台执行,结果推回对应平台。

你换设备、换软件,Agent 始终是同一个,记忆与技能共享。

安全建议

  • 网关暴露在外网,建议只开你真正使用的平台。
  • Bot Token 等凭据放在 ~/.hermes/.env,不要提交到仓库。
  • 给网关会话配置最小必要工具集,减少误调用风险。

结合定时任务

网关和定时任务(下一篇)配合最佳:定时任务在后台跑,跑完通过网关把结论推到你指定的平台。例如每两小时检查一次服务器,异常才发飞书消息给你,正常则静默。

本篇小结

  • 网关是常驻服务,让 Hermes 进驻聊天软件,实现多端值守。
  • hermes gateway setup 配置,hermes gateway start 启动。
  • 原生对接 Telegram/Discord/Slack/WhatsApp/Signal/Email/HomeAssistant/Teams。
  • 投递目标额外支持飞书、钉钉、企业微信、微信、QQ。

下一篇我们讲定时任务,让 Hermes 按时间表自动干活。

上一篇
Hermes 自动生成技能
下一篇
Hermes 定时任务