Hermes Agent Channels
31 通道深度调查报告

调查日期：2026-06-29 · 数据来源：Hermes Agent 官方文档、GitHub 源码仓库

一、通道架构总览

Hermes Agent 的通道系统分为两个层级：核心内置通道（24个，在 gateway/config.py 的 Platform 枚举中硬编码）和 插件扩展通道（7个，通过 plugins/platforms/ 目录自动发现）。插件通道通过 PEP 562 __getattr__ 机制实现延迟加载，按需导入，零额外启动开销。

二、31 通道完整清单

三、功能特性矩阵

以下数据提取自官方文档 Messaging Gateway 页面。

注：SMS、Home Assistant、WeCom Callback、ntfy、Raft 不支持以上任何特性。IRC 仅纯文本。SimpleX 和 Photon 文档未列入此表但支持附件。

四、通道分类分析

4.1 国际主流 IM 通道（Tier 1）

Telegram 是 Hermes 最成熟、功能最全的通道。支持 polling/webhook 双模式，streaming、voice transcription、cron delivery、群组管理一应俱全。Webhook 模式适用于 Fly.io / Railway 等云部署场景的 sleep-when-idle。适配器代码在 gateway/platforms/telegram.py，是参考实现的范本。

Discord 和 Slack 均已迁移至 plugins/platforms/ 插件架构。Discord 需配置 Message Content Intent 和 Privileged Gateway Intents。二者均支持 reactions、threads、streaming、typing indicator 和 slash commands。

WhatsApp 有两套独立适配器：

• Baileys bridge（whatsapp）：模拟 WhatsApp Web 会话，QR 码配对，零 Meta 账号，但有轻微封号风险。适合个人使用和测试。
• Cloud API（whatsapp_cloud）：Meta Business 官方 API，需 Business 账号 + 公网 HTTPS webhook，原生 interactive buttons、已读回执、HMAC 签名验证。适合生产环境。

Signal 依赖外部 signal-cli 守护进程（HTTP 模式），通过 SSE 接收消息、JSON-RPC 发送。需要实体手机号注册和 linked device 配对。支持原生格式化（bodyRanges）、reply quotes、reactions、100MB 文件、多图批量发送（32 张一批）。

Matrix 和 Mattermost 覆盖自托管/联邦化场景。Matrix 通过联邦协议天然支持跨服务器通信和 E2E 加密房间。

4.2 中国生态通道（Tier 3）

中国生态是 Hermes 通道体系中最密集的区域，涵盖9个通道：

4.3 通知/基础设施通道（Tier 4）

ntfy.sh 是轻量级 HTTP pub-sub 方案。核心优势：零依赖（用 Hermes 已有的 httpx），手机端 app 即收即回，支持 outgoing-only 模式作为纯推送通道。安全提示：ntfy 没有原生用户认证——topic 名称即为身份。使用随机 topic 名或配置 token 保护。

Email 通过 SMTP/IMAP 连接，利用 In-Reply-To 头实现会话线程。无 streaming、无 typing、无 reactions，但附件支持完整。适用于异步、长周期对话场景。

SMS (Twilio) 需 Twilio 账号和公网 webhook URL。HMAC-SHA1 签名防伪造。160 字符分段。明文传输无加密，不适合敏感操作。

API Server 提供 OpenAI 兼容的 REST API（/v1/chat/completions、/v1/responses、/v1/runs），支持 X-Hermes-Session-Id 会话持久化和 X-Hermes-Session-Key 长期记忆作用域。Open WebUI 通过此适配器接入。

Webhook 接收 GitHub/GitLab/JIRA/Stripe 等外部服务的 POST 事件，经 HMAC 验证 + payload 模板转换后触发 agent run。结果可路由回源平台或任意配置的通道。

Home Assistant 通过 WebSocket 接入智能家居平台，使 Hermes 成为家庭语音/文字对话代理。

IRC 是 Hermes 最新加入的通道之一（适配器先于文档交付，PR #54254 补齐文档）。纯 Python asyncio 实现，零外部依赖。支持 Libera.Chat 等公共网络和自托管 ircd。NickServ 自动认证。纯文本，450 字符行限制。

SimpleX Chat 是目前隐私性最高的通道——无持久用户 ID、去中心化、端到端加密。需本地运行 simplex-chat 守护进程。

Raft 是实验性的 agent-to-agent 网络协议，用于多 agent 实例间的消息传递和协作。

Relay 是通用中继适配器（实验性），由外部 connector 驱动，面向未来自定义桥接场景。

Local 是 CLI/TUI/Desktop 三种表面的统一入口。所有其他通道都通过 Gateway Runner 调用同一 AIAgent 核心，只有 Local 直接面向终端用户。

五、技术架构

架构要点：

• 每个通道适配器继承 BasePlatformAdapter，实现 connect()、send_message()、handle_message() 等核心方法
• 消息通过 GatewayRunner 路由至 AIAgent，session 按 chat_id 隔离
• Cron 调度器（60s tick）支持指定平台投递（deliver="telegram"）
• 插件通道通过 plugin.yaml + PEP 562 __getattr__ 实现零开销懒加载
• Silence token 机制（[SILENT] / NO_REPLY）允许 agent 在无需回复时静默
• 流式响应（streaming）支持 draft/edit 两种传输模式，Telegram 还支持 fresh_final_after_seconds 最终消息重发

六、关键发现与洞察

6.1 架构演进：从硬编码到插件化

Hermes 通道体系正处于从核心硬编码向插件架构迁移的过程中。Discord、Slack、Matrix、Mattermost、Feishu、DingTalk 等已从 gateway/platforms/ 迁移至 plugins/platforms/。但 Platform 枚举中仍保留这些值以确保向后兼容。新的 LINE、IRC、SimpleX 通道直接以插件形式发布，无需修改核心代码（参见 Issue #40181 关于 LINE 在 Platform 枚举中缺失导致 channel_prompts 静默失效的已知问题）。

6.2 中国生态密度最高

31 个通道中有 9 个（29%）针对中国市场：Feishu、DingTalk、WeCom、WeCom Callback、Weixin、QQ、Yuanbao、BlueBubbles、Photon（后两者虽非中国平台，但 iMessage 在中国用户中占比较高）。腾讯系独占 5 个（WeCom ×2 + Weixin + QQ + Yuanbao），反映 Hermes 在中国开发者社区的定位。

6.3 WhatsApp 双适配器策略

Baileys bridge（低门槛、有风险）和 Cloud API（高门槛、生产级）的双轨制为不同阶段用户提供平滑升级路径。两套适配器共享 WhatsAppBehaviorMixin（whatsapp_common.py）实现代码复用。

6.4 安全模型分层

• Allowlist（默认拒绝）：所有平台默认拒绝所有用户，除非在 allowlist 或通过 DM pairing 授权
• Webhook 签名验证：Telegram (HMAC-SHA256)、SMS/Twilio (HMAC-SHA1)、Webhook (HMAC-SHA256)、LINE (HMAC-SHA256)、Feishu (SHA256 签名)
• SSRF 防护：Yuanbao 通道近期修复了 SSRF 漏洞（PR #54470），通过 is_safe_url 检查 + 异步 redirect hook 双重验证所有媒体 URL
• AES 媒体解密：WeCom 自动处理 AES-256-CBC 加密的入站媒体

6.5 流式响应差异

Telegram、Discord、Slack、Matrix、Feishu、WhatsApp、Signal、Weixin、Yuanbao 支持流式输出（progressive edits）。WeCom 和 Email 不支持——每次响应作为单个完整消息发送。LINE、IRC、SMS、ntfy 也不支持流式。

七、数据来源

• Hermes Agent Docs · Messaging Gateway
• gateway/config.py · Platform Enum
• plugins/platforms/ · GitHub
• gateway/platforms/ · GitHub
• Issue #40181 · LINE in Platform enum gap
• PR #54254 · Docs reconciliation (IRC page)
• PR #54470 · SSRF fix for Yuanbao