一、引言：AI 的入口正在发生变化

过去几年，我们使用 AI 的方式非常固定：

• 打开网页（如 ChatGPT）
• 打开 IDE（如 Copilot）
• 调用 API

但 Hermes Agent 做了一件更激进的事情：

让 AI 直接进入你的“沟通环境”

也就是说：

👉 AI 不再是一个工具，而是一个“常驻的协作对象”。

而实现这一点的核心，就是：

Messaging Gateway（消息网关）

---

二、Messaging Gateway：Hermes 的核心架构

2.1 什么是 Messaging Gateway

Messaging Gateway 本质是一个：

统一通信抽象层（Unified Communication Layer）

它的作用是：

用户（Telegram / Discord / 微信）
↓
Messaging Gateway
↓
Hermes Agent Core
↓
工具 / Memory / Skill

---

2.2 为什么一定要做这一层？

传统 AI 的问题：

模式	缺陷
Web UI	不在工作流中
API	无长期上下文
CLI	使用门槛高

Hermes 的解法：

把 AI 放进你已经在用的地方（Messaging）

---

三、支持的平台（重点含微信）

Hermes Messaging 官方支持的消息来源包括：

• Telegram
• Discord
• Slack
• WhatsApp
• Signal
• Matrix
• Email
• WeCom（企业微信）
• Weixin（微信）

👉 这里非常关键：

Hermes 在架构层面“原生支持微信作为消息源”

---

四、关键澄清：支持微信 ≠ 开箱即用

这是很多人第一次用 Hermes 会踩的坑。

4.1 官方支持的含义

Hermes 中：

• wecom
• weixin

是正式的 session source 类型

意味着：

👉 系统可以处理来自微信的消息、管理会话、维护上下文

---

4.2 但 Hermes 不负责什么？

Hermes 不负责：

• 登录微信
• 扫码
• 建立连接
• 接收原始消息

👉 它只处理：

“已经进入系统的消息”

---

4.3 正确理解（非常重要）

微信客户端
↓
（你自己的接入方式 / Bot / Webhook）
↓
Hermes Messaging Gateway（weixin source）
↓
Agent

---

五、Messaging 工作机制详解

5.1 消息生命周期

1️⃣ 用户发送消息
2️⃣ Gateway 捕获
3️⃣ 转换为 Hermes 格式
4️⃣ Agent 推理（调用工具）
5️⃣ 返回结果

---

5.2 Session（会话）机制

Hermes 的核心优势之一：

👉 长期上下文

支持：

• 跨平台会话延续
• 历史记忆
• 用户级上下文

---

5.3 群聊隔离机制

group_sessions_per_user: true

模式	行为
true	每人独立上下文
false	群共享上下文

---

5.4 @mention 机制（以 Discord 为例）

require_mention: true

👉 防止 AI 变成“群聊噪音”

---

六、Streaming（流式输出）

streaming:
enabled: true

Hermes 支持：

👉 边生成边发送（类似打字）

工程价值：

• 更自然
• 可中断
• 提高交互感

---

七、跨平台统一大脑（核心能力）

Hermes 的一个关键突破：

一个 Agent，多入口共享状态

例如：

• Telegram 提问
• Discord 继续
• CLI 执行任务

👉 全部共享同一上下文

---

八、Messaging + Memory：形成智能闭环

Hermes 会：

1. 记录对话
2. 提取长期知识
3. 建立用户模型

形成：

Messaging → Memory → Skill → 再用于 Messaging

---

九、Messaging + Tool：从聊天到执行

Hermes 的本质不是聊天，而是：

执行系统

例如：

用户：查天气
→ Hermes 调用 API
→ 返回结果

---

十、自动化能力（Automation）

Hermes 支持：

• 定时任务（cron）
• 主动推送

例如：

每天 9 点 → 自动发送日报

---

十一、安全机制

11.1 审批机制

approvals:
mode: manual

---

11.2 隐私保护

privacy:
redact_pii: true

---

十二、重点章节：微信接入实战（完整版）

这一部分是很多人最关心的，也是最容易误解的。

---

12.1 微信接入的两条路径

✅ 路径一：企业微信（WeCom）

对应 Hermes：

• wecom

特点：

• 官方 API
• 稳定
• 可生产使用

👉 强烈推荐

---

⚠️ 路径二：个人微信（Weixin）

对应 Hermes：

• weixin

特点：

• Hermes 支持该 source
• 但需要你自己接入链路

---

12.2 架构设计（标准方案）

微信用户
↓
企业微信 / 第三方入口
↓
Adapter（你写的服务）
↓
Hermes Gateway
↓
Agent
↓
返回微信

---

12.3为什么必须有 Adapter？

因为：

👉 Hermes 不处理微信协议

你必须做：

1. 消息转换
2. session 映射

---

12.4 核心实现流程

Step 1：接收微信消息

userId = wechat_user_id
content = message

---

Step 2：调用 Hermes

POST /chat
{
session_id,
message
}

---

Step 3：返回微信

<xml>
<Content>回复内容</Content>
</xml>

---

12.5 Session 设计（关键）

wechat_user_id → hermes_session_id

建议：

• Redis 存储
• 支持长期会话

---

12.6 Streaming 处理

微信：

👉 不支持真实流式

解决：

• 分段发送
• 或一次性返回（推荐）

---

12.7 安全控制（必须做）

• 白名单
• 限流
• 审批机制

---

12.8 常见坑

❌ 直接用个人微信
→ 高概率封号

❌ 没有 session
→ 上下文混乱

❌ 长消息
→ 发送失败

---

12.9 关键总结（非常重要）

Hermes 原生支持微信作为消息源，但不提供完整接入基础设施。

---

十三、工程价值总结

Hermes Messaging 带来的变化：

13.1 从工具 → 助手

传统：打开 AI
Hermes：直接发消息

---

13.2 从调用 → 持续协作

• 长期记忆
• 自动执行
• 多平台同步

---

13.3 从聊天 → 操作系统

Messaging = AI OS 的入口

---

十四、与其他 Agent 对比

系统	Messaging
AutoGPT	❌
LangChain Agent	❌
GPTs	⚠️
Hermes	✅

---

十五、最佳实践（落地建议）

推荐组合：

• Hermes + Telegram（个人）
• Hermes + Discord（团队）
• Hermes + 企业微信（生产）

---

十六、未来趋势：Messaging 即操作系统

Hermes 的方向很明确：

未来的 AI，不再是 App，而是“对话入口”

---

结语

Hermes Messaging 做的不是“多平台支持”，而是：

重构 AI 的交互方式

尤其是微信这一块：

• 官方已支持 source（weixin / wecom）
• 但工程落地需要你接入链路

理解这一点，你就真正理解了 Hermes 的设计哲学。