Gateway让 Hermes 无处不在前言前面几篇文章我们一直在终端里和 Hermes 交互。但 Hermes 的设计远不止于此——通过内置的Gateway网关同一个智能体可以同时接入 15 个即时通讯平台。你在 Telegram 上发一条消息、在 Discord 里跟进、在终端里查看结果所有平台共享同一个上下文和记忆。一、Gateway 架构1.1 消息流转Agent 核心Gateway 核心消息入口TelegramDiscordSlack微信钉钉飞书邮件终端 CLI消息路由认证鉴权消息队列会话管理对话循环工具执行记忆注入1.2 会话模型Gateway 的核心设计是会话Session。每个聊天窗口Telegram 私聊、Discord 频道、Slack 线程都绑定到一个独立的会话Telegram 私聊: 小明Session ATelegram 群组: 技术群Session BDiscord #generalSession C终端 CLISession D不同平台的会话完全隔离但共享同一个 Memory 和 Skills。二、支持的平台2.1 完整平台列表平台类型安装难度推荐场景Telegram即时通讯⭐ 简单个人首选Bot API 完善Discord社区/团队⭐ 简单团队协作Slack企业通讯⭐⭐ 中等企业内部企业微信国内企业⭐⭐ 中等国内企业用户钉钉国内企业⭐⭐ 中等国内企业用户飞书国内企业⭐⭐ 中等国内企业用户微信个人通讯⭐⭐⭐ 复杂个人使用WhatsApp个人通讯⭐⭐ 中等海外用户Signal加密通讯⭐⭐ 中等隐私敏感Matrix去中心化⭐⭐ 中等自建服务邮件异步通讯⭐ 简单异步任务短信移动通讯⭐⭐ 中等通知提醒API ServerHTTP API⭐ 简单程序调用Webhooks事件触发⭐ 简单自动化触发Home Assistant智能家居⭐⭐ 中等家居控制2.2 中国用户推荐个人使用企业办公团队开发自动化你的场景?Telegram 终端飞书 / 企业微信 / 钉钉Discord 终端Webhooks Cron三、Telegram 接入实战Telegram 是配置最简单、体验最完整的平台我们以此为例。3.1 创建 Bot在 Telegram 中找到BotFather发送/newbot按提示设置名称和用户名获取Bot Token格式如123456:ABC-DEF1234ghikl...3.2 配置 Hermes# 启动 Gateway 设置hermes gateway setup选择 Telegram输入 Bot Token。或者直接编辑配置# ~/.hermes/config.yamlgateway:platforms:telegram:enabled:truetoken:123456:ABC-DEF1234ghikl...3.3 启动 Gateway# 前台运行调试用hermes gateway run# 安装为后台服务推荐hermes gatewayinstall# 管理服务hermes gateway start hermes gateway stop hermes gateway restart hermes gateway status3.4 在 Telegram 中使用启动 Gateway 后在 Telegram 中找到你的 Bot发送/start。然后就可以像在终端里一样对话了。Telegram 上可用的斜杠命令命令功能/start开始对话/new开启新会话/model查看当前模型/approve批准待确认的命令/deny拒绝待确认的命令四、Discord 接入4.1 创建 Bot 应用访问 Discord Developer Portal创建新应用进入 Bot 设置重要在 Privileged Gateway Intents 中开启Message Content Intent获取 Bot Token4.2 配置 Hermesgateway:platforms:discord:enabled:truetoken:你的 Discord Bot Token4.3 邀请 Bot 到服务器在 Discord Developer Portal → OAuth2 → URL Generator 中Scope 选择botBot Permissions 选择Send Messages、Read Message History用生成的链接邀请 Bot 到你的服务器五、中国企业平台接入5.1 飞书接入飞书需要创建企业自建应用配置流程略复杂但文档完善飞书开放平台 创建应用获取App ID和App Secret配置 Hermesgateway:platforms:feishu:enabled:trueapp_id:cli_xxxxxapp_secret:xxxxx5.2 企业微信 / 钉钉企业微信和钉钉的接入流程类似都需要在企业后台创建应用、配置回调 URL。详细的配置参数请参考 Hermes 官方文档。六、高级 Gateway 功能6.1 首页频道Home Channel设置一个首页频道让 Hermes 知道这是默认的会话入口# 在目标聊天中发送 /sethome6.2 跨平台消息发送Hermes 可以从一个平台向另一个平台发送消息在 Telegram 上帮我在 Discord #general 频道通知大家服务器维护完成6.3 DM 授权管理Gateway 支持 DM 授权管理控制谁可以直接和你的 Hermes 对话# 查看待授权请求hermes pairing list# 批准授权hermes pairing approve用户ID# 撤销授权hermes pairing revoke用户ID6.4 会话主题在 Telegram 中可以启用基于 Topic话题的会话隔离/topic on七、Gateway 运维7.1 日志查看# 实时日志tail-f~/.hermes/logs/gateway.log# 查看最近错误greperror\|failed~/.hermes/logs/gateway.log|tail-207.2 常见问题问题原因解决方案SSH 登出后 Gateway 退出systemd linger 未启用sudo loginctl enable-linger $USERWSL 关闭后 Gateway 退出WSL systemd 未启用编辑/etc/wsl.conf添加systemdtrueDiscord Bot 不响应Message Content Intent 未开启在 Developer Portal 开启Gateway 反复崩溃服务状态异常systemctl --user reset-failed hermes-gatewaySlack Bot 只在私聊工作缺少频道事件订阅订阅message.channels事件7.3 平台状态查看# 查看所有平台连接状态hermes status--all# 或在会话中/platforms八、安全建议Gateway 让你的 Hermes 暴露在公网消息平台中安全配置尤为重要# 建议的安全配置security:approvals:mode:manual# 保持手动审批不要开 yologateway:dm_policy:whitelist# 私聊白名单模式pairing_required:true# 要求配对授权核心原则在公网平台Telegram/Discord始终保持命令审批为manual模式启用 DM 白名单只允许授权用户交互不要在群聊中暴露敏感信息总结Gateway 让 Hermes Agent 从一个终端工具升维为一个无处不在的 AI 助手15 平台统一接入跨平台共享上下文和记忆多会话隔离、灵活授权配置一个 Telegram Bot 只需 5 分钟却能让你在任何地方随时召唤 Hermes。下一篇文章我们将进入高阶玩法多智能体协作与任务编排。作者汤粉ai系列《Hermes Agent 从入门到精通》上一篇工具系统详解下一篇多智能体与任务编排