hermes agent需通过hermes gateway setup交互式向导统一配置全部消息平台，先运行hermes doctor验证23项网关支持情况，再按依赖分组输入各平台凭证，避免手动编辑导致路由冲突或消息丢失。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在 Telegram、Discord、微信、飞书、企业微信、钉钉等全部支持平台一次性完成 Hermes Agent 消息网关配置，必须绕过零散手动编辑，直接利用其内置交互式向导统一驱动凭证注入、权限校验与服务重载，否则各平台会因路由冲突或会话隔离失效而消息丢失。
验证本地运行环境与平台支持清单
打开终端，执行 hermes doctor。等待输出完成后，重点查看【Gateways】区域列出的平台名——共 23 项，包括 feishu、wecom、dingtalk、telegram、weixin、slack、discord、matrix、whatsapp（via Twilio）等。若某平台未出现，说明当前二进制未编译该适配器，需升级至 v0.14.0+ 或重装时带 [all] 选项。
这一步不能跳过。很多用户卡在后续步骤，根源是误以为平台“支持”等于“已编译进本地可执行文件”，实际必须通过 hermes doctor 真实验证。
启动交互式网关配置向导
在终端中直接运行：hermes gateway setup。
向导会自动检测已启用的平台模块，并按依赖关系分组推进：先问 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-bot-token" allowed_users: - your_telegram_user_id
飞书平台接入（需管理员权限）
第一步：在飞书开放平台创建并配置应用
访问飞书开放平台 → 点击“创建企业自建应用” → 填写应用名称与描述 → 创建成功后，进入“应用功能” → 开启“机器人”能力 → 进入“权限管理” → 添加 im:message:send_as_bot、im:message:read、contact:user:readonly 权限 → 点击“发布”使权限生效。
第二步：获取凭证并填入向导
在“凭证与基础信息”页复制 App ID 和 App Secret → 返回终端，在 hermes gateway setup 向导中选择 feishu → 输入 App ID 和 App Secret → User IDs 留空（开放给所有用户）→ Domain 保持默认 feishu → Connection mode 选择 websocket（推荐）。
第三步：配置事件订阅（关键！）
回到飞书开放平台 → 进入“事件与回调” → 订阅方式选择“长连接” → 勾选 im.message.receive_v1 → 保存。
微信平台接入（仅支持个人账号扫码）
执行 hermes gateway setup wechat，终端将生成一个二维码。
用任意微信（非企业微信）客户端扫码，完成账号绑定；绑定成功后，该微信账号即成为 Hermes Agent 的「主控入口」，所有其他平台消息都会路由至此进行统一上下文调度。
这一步操作起来很简单，直接把文件拖进去就行——但必须使用个人微信扫码，【企业微信、微信工作台、微信公众号后台均不支持】，否则 gateway 会卡在 waiting for scan 状态超过 90 秒后退出。
企业微信与钉钉批量接入（多账号管理）
执行 hermes gateway add，按提示依次选择平台类型：输入 1 选 wecom，输入 2 选 dingtalk，输入 3 选 feishu 等。
每选一个平台，向导会要求你输入对应凭证：
— 企业微信需提供 corpid、corpsecret、agentid；
— 钉钉需提供 appkey、appsecret、encrypt_key、verification_token。
凭证校验通过后，自动写入 ~/.hermes/config.yaml 的 accounts: 列表下，每个实例独立隔离 session_id，确保消息路由不串流。
