hermes agent支持23个平台一次性接入，包括飞书、企微、钉钉、telegram、微信等，通过hermes doctor验证编译支持，再用hermes gateway setup交互式向导完成配置，各平台需按要求在对应管理后台完成事件订阅或登录授权。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
把 Hermes Agent 接进你每天打开几十次的聊天软件，让它在飞书收会议纪要、在钉钉自动回审批、在 Telegram 推送监控告警、在微信里帮你写周报——不是只接一个平台试水，而是把全部 23 个支持平台一次性配齐、跑通、分权限管控。
确认 Hermes 已就绪并查看全平台列表
打开终端，执行：
hermes doctor
等待输出完成，重点看 【Gateways】 区域。这里会列出所有已编译支持但尚未配置的平台名，共 23 项，包括 feishu、wecom、dingtalk、telegram、weixin、slack、discord、matrix、irc、whatsapp（via Twilio）、line、kakao、msteams、rocketchat、mattermost、zulip、gotify、pushover、email、sms（via Twilio）、nats、redis、webhook。若某平台未出现在列表中，说明当前二进制不包含该 gateway，需重新安装或升级到 v0.14.0+ 版本。
这一步不能跳过。很多用户卡在后续步骤，根源是误以为平台“支持”等于“已编译进本地可执行文件”，实际必须通过 hermes doctor 真实验证。
通用配置入口：交互式网关向导启动
在终端中运行：
hermes gateway setup
命令会立即启动交互式向导，自动检测已启用的平台模块，并逐个询问是否配置。它不会一次性问完全部 23 个，而是按依赖关系和常用度分组推进：先问 Telegram/WhatsApp/Email 这类无需企业权限的轻量平台，再问飞书/企微/钉钉这类需管理员权限的，最后才提示 Matrix/NATS/Redis 等高级集成项。
向导过程中，每选一个平台，就会进入该平台专属配置流程。按提示输入凭证即可，无需手动编辑 YAML 文件——这是最安全、最不易出错的方式。
Telegram：5分钟零门槛接入
方法一：BotFather 创建 + 向导填入
① 在 Telegram 中搜索 @BotFather → 发送 /newbot → 按提示设置名称（如 hermes-ai-bot）→ 获得形如 【1234567890:ABCdefGHIjklMNOpqrSTUvwxYZ123456789】 的 Bot Token。
② 回到 hermes gateway setup 向导，当提示 “Select gateway” 时输入 telegram → 粘贴 Bot Token → 输入你的 Telegram 用户 ID（发送 /my_id 到 @userinfobot 获取）→ 完成。
方法二：手动补全 config.yaml（仅当向导异常时使用）
编辑 ~/.hermes/config.yaml，在 gateways 下添加：
telegram:
enabled: true
bot_token: "your-token-here"
allowed_users:
- 123456789
注意：allowed_users 必须是数字 ID，不能是用户名，否则 Bot 收不到任何消息。
飞书/企微/钉钉：三平台统一配置逻辑
这三者都要求企业级应用创建与权限审批，但 Hermes 向导已将流程收敛为同一套交互路径：
选择平台（feishu/wecom/dingtalk）→ 输入 App ID / Corp ID / AppKey → 输入 App Secret / Secret / AppSecret → 输入 Token 和 AES Key（企微/钉钉必填，飞书可选）→ 选择连接模式（websocket 推荐，http fallback 备用）→ 自动输出回调地址与事件订阅清单。
关键动作必须离线完成：
飞书：登录飞书开放平台 → 应用详情页 → 事件订阅 → 勾选 im.message.receive_v1 → URL 填向导输出的 https://your-domain/webhook/feishu → 保存；
企微：管理后台 → 应用管理 → 对应应用 → 接收消息 → URL 填 https://your-domain/webhook/wecom → 设置 Token 和 AES Key → 保存；
钉钉：钉钉开放平台 → 应用开发 → 机器人 → 消息接收 → 地址填 https://your-domain/webhook/dingtalk → 开启加解密 → 填入向导生成的 AES Key。
这三步漏掉任意一个，平台消息就进不来。向导只生成配置，不代替你在管理后台点保存。
微信接入：扫码登录型通道
微信不走 webhook，而是基于 PC 微信客户端协议模拟登录：
在 hermes gateway setup 中选择 weixin → 向导会输出一行提示：“Start QR login now? [y/N]” → 输入 y → 终端立即生成二维码 → 用手机微信「扫一扫」识别 → 手机端确认登录。
成功后，Hermes 会在 ~/.hermes/storage/weixin/ 下保存 session 文件。下次重启无需重复扫码，除非微信主动踢下线或清理了登录态。
注意：微信通道仅支持个人号，企业微信请走 wecom 通道。二者配置完全隔离，不可混用。
Webhook 通用网关：对接任意 HTTP 消息源
当你要接入自建系统、IoT 设备或内部 CRM 时，用 webhook 通道最灵活：
hermes gateway setup → 选择 webhook → 输入监听端口（默认 8080）→ 设置 secret（用于校验请求签名）→ 配置 route mapping（例如 POST /alert → 转发给 default profile）。
配置完成后，Hermes 会启动一个独立 HTTP 服务，地址为 http://localhost:8080/webhook。任何能发 HTTP POST 请求的系统，只要带正确 X-Hermes-Signature 头，就能把消息推送给 Hermes。
这一步不需要外部平台注册，但必须确保你的服务器防火墙放行该端口，且反向代理（如 Nginx）已将公网域名路由到此端口。
Matrix / NATS / Redis：高阶消息总线接入
Matrix（去中心化通讯协议）：
选择 matrix → 输入 Homeserver URL（如 https://matrix.org）→ 输入用户名和密码 → 向导自动获取 access token 并加入指定 room。
NATS（云原生消息系统）：
选择 nats → 输入 server URL（如 nats://localhost:4222）→ 输入 credential file 路径（由 nats-server 生成）→ 指定 subject（如 hermes.inbound）。
Redis（轻量 Pub/Sub）：
选择 redis → 输入 redis://host:port/db → 输入 channel 名（如 hermes:input）→ 启用 JSON 解析开关。
这三个平台不提供图形化管理界面，全部依赖 CLI 配置与日志观测。首次运行后，务必执行 hermes logs -f 查看实时连接状态，确认 CONNECTED 字样出现。
