04 | Hermes Agent 进阶实战 —— 多平台接入、定时任务与子 Agent 并发

04 | Hermes Agent 进阶实战 —— 多平台接入、定时任务与子 Agent 并发

声明：📝 作者：甜城瑞庄的核桃（ZMJ）
原创学习笔记，欢迎分享，但请保留作者信息及原文链接哦～

适合人群：已掌握基础配置，想解锁高级能力的开发者
前置知识：完成前三篇学习（安装配置、记忆系统、技能系统）
学习目标：深入理解并实战 Gateway 多平台接入机制、自然语言定时任务调度、子 Agent 并发工作流编排，以及模型智能路由与安全防线

📌版本说明：本文基于 Hermes Agentv0.10.0（2026.4.16），技术细节随版本迭代可能变化，如有出入请以 官方文档 为准。

一、消息 Gateway：统一网关的架构原理与实战配置

1.1 Gateway 架构：为什么能跨平台保持上下文？

Hermes 的 Gateway 并不是简单的消息转发代理，而是一个统一 Agent 会话入口。所有平台的消息最终都路由到同一个AIAgent实例，底层共享同一份 SQLite 会话数据库（hermes_state.py）。

用户（Telegram） 用户（Discord） 用户（CLI） │ │ │ ▼ ▼ ▼ ┌────────────────────────────────────────────────────┐ │ Gateway 统一消息网关 │ │ gateway/run.py (~9,000 行代码) │ │ ┌──────────┐ ┌──────────┐ ┌──────────────────┐ │ │ │Telegram │ │Discord │ │Slack/飞书/钉钉...│ │ │ │Adapter │ │Adapter │ │Adapter │ │ │ └────┬─────┘ └────┬─────┘ └────────┬─────────┘ │ │ └─────────────┼─────────────────┘ │ │ ▼ │ │ ┌──────────────────────┐ │ │ │ 统一消息格式化层 │ │ │ │ (用户ID / 会话ID / │ │ │ │ platform标签) │ │ │ └──────────┬───────────┘ │ └─────────────────────┼──────────────────────────────┘ ▼ ┌───────────────────────┐ │ AIAgent 核心 │ │ run_agent.py │ │ (对话循环 + 工具分发) │ └───────────┬───────────┘ ▼ ┌───────────────────────┐ │ hermes_state.py │ │ SQLite + FTS5 │ │ 跨平台共享会话存储 │ └───────────────────────┘

关键机制：每个用户在每个平台的组合(platform, user_id)会被映射到一个唯一的session_id，但同一用户在不同平台可以通过/resume命令切换到同一个命名会话。

1.2 配置 Telegram Bot（最稳定的平台，推荐首选）

Step 1：创建 Bot

1. 在 Telegram 搜索 @BotFather 2. 发送 /newbot，输入名称和用户名 3. 获取 Bot Token（格式：1234567890:AAxxxxxxxxxxxxxx） 4. 发送 /setcommands，添加常用命令（可选）

Step 2：获取你的 User ID

# 方法：向 @userinfobot 发送任意消息，它会回复你的 User ID # 将此 ID 填入白名单，防止其他人使用你的 Bot

Step 3：配置并启动

hermes gateway setup telegram# 提示：Bot Token: 1234567890:AAxxxxxx# 提示：允许访问的用户 ID（多个用逗号分隔）: 12345678hermes gateway start telegram

v0.8.0 新特性：Telegram 现支持通过发送表情符号来批准危险命令，无需手动输入y。收到危险命令提示后：

• 发送 ✅ = 允许本次
• 发送 ❌ = 拒绝

1.3 配置 Discord Bot

hermes gateway setup discord# 需要：Bot Token / 服务器 ID / 频道 IDhermes gateway start discord

Discord 支持斜杠命令（Slash Commands），可以在频道中直接使用/hermes ask <问题>与 Agent 交互，而不需要 @ 机器人。

1.4 配置飞书 / 钉钉（国内企业场景）

飞书配置步骤：

# 1. 前往飞书开放平台 (open.feishu.cn) 创建自建应用# 2. 获取 App ID 和 App Secret# 3. 配置消息权限：im:message 和 im:message:receive_v1# 4. 添加机器人能力，获取 Webhook URLhermes gateway setup feishu# 提示输入：App ID / App Secret# 来源选择：feishu（国内版）或 lark（海外版）# 连接方式：websocket（推荐，长连接无需公网 IP）hermes gateway start feishu

⚠️ Windows 坑点：飞书 SDKlark-oapi需手动安装到 Hermes 的 venv 中：

uv pip install lark-oapi--python"C:\Users\<用户名>\AppData\Local\hermes\hermes-agent\venv\Scripts\python.exe"

钉钉配置步骤：

# 1. 钉钉开放平台创建企业内部应用# 2. 获取 AppKey 和 AppSecret# 3. 配置消息接收回调 URL（需要公网可访问，或用 frp/ngrok 内网穿透）hermes gateway setup dingtalk hermes gateway start dingtalk

1.5 多平台支持全览

1.6 跨平台会话同步：实战技巧

所有平台共享同一个 Agent 的记忆系统和技能库，但默认情况下每个平台有独立会话。若要跨平台接续对话：

# 在 CLI 中给当前会话命名/title 项目-Alpha开发# 在 Telegram 中恢复同名会话/resume 项目-Alpha开发

最佳实践：为长期进行的项目创建命名会话，不论从哪个平台接入都能无缝继续。

二、定时任务：自然语言版 Crontab 的底层机制</