Hermes Agent 接 WhatsApp，最关键的是先把网关跑通，再把允许用户和默认投递目标配好。官方文档的思路很直接：先通过 hermes gateway setup 或 hermes whatsapp 完成二维码配对，然后设置 WHATSAPP_ALLOWED_USERS、WHATSAPP_HOME_CHANNEL 这类环境变量。
最短配置流程
- 在服务器或常开机器上安装 Hermes Agent。
- 运行
hermes gateway setup选择 WhatsApp，或单独执行相关 WhatsApp 配对流程。 - 手机扫二维码，把这个实例当成你的 Linked Device。
- 在
~/.hermes/.env里补WHATSAPP_ALLOWED_USERS，必要时再配WHATSAPP_HOME_CHANNEL。 - 启动
hermes gateway，用自己的账号先发一条测试消息。
最容易踩的坑
- 手机必须保持在线，长时间断网容易触发重新配对。
- 如果总让你重扫二维码，先检查 session 目录有没有持久化。
- 不要自动外发陌生联系人，文档也明确提醒不要把 WhatsApp 当冷启动营销工具。
- 群里要不要开放给所有人，优先用 allowlist，不要直接放开全员。
一句话：Hermes Agent 的 WhatsApp 配置重点不是“能扫上码”，而是“会话持久化、允许名单和默认投递频道”三件事一起配对。
官方开源地址：https://github.com/NousResearch/hermes-agent；官方文档入口：https://hermes-agent.nousresearch.com/。
