飞书与钉钉双平台消息互通需完成网关配置（交互式或手动编辑config.yaml）及平台侧事件订阅：飞书选websocket并订阅im.message.receive_v1，钉钉配token/aes key并设置webhook url。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已部署 Hermes Agent，但飞书或钉钉平台无法接收消息或发送回复失败，则可能是网关未正确配置或平台侧事件订阅缺失。以下是实现飞书与钉钉双平台消息互通的具体配置步骤：
一、配置飞书网关（交互式向导方式）
该方式通过命令行交互完成基础参数注入，适用于快速验证与初始部署，无需手动编辑 YAML 文件。系统将自动生成适配飞书开放平台要求的认证与连接配置。
1、在已运行 Hermes Agent 的服务器终端中执行：hermes gateway setup。
2、在向导提示中选择平台类型为 feishu。
3、依次输入飞书开放平台获取的 App ID 与 App Secret。
4、User IDs 字段留空以允许全组织用户访问，或填入测试用飞书用户 ID（如 udmxxxxxxxxxxxxx）。
5、Domain 保持默认 feishu，Connection mode 选择 websocket。
二、配置飞书网关（手动编辑 config.yaml 方式）
该方式提供更精细的控制能力，支持启用加密通信、设置验证令牌及调试模式，适合生产环境长期稳定运行。
1、使用文本编辑器打开配置文件：~/.hermes/config.yaml。
2、在 gateways 节点下添加或修改 feishu 配置块，确保包含以下字段：
3、app_id 值设为飞书应用凭证页中的 App ID（格式如 cli_xxxxxxxxxxxxxx）。
4、app_secret 值设为对应 App Secret。
5、verification_token 和 encrypt_key 需在飞书开放平台“事件订阅”页复制粘贴，二者必须与平台侧配置完全一致。
三、配置钉钉网关（交互式向导方式）
该方式利用 Hermes 内置向导自动填充钉钉所需的 AppKey、AppSecret 及加解密参数，降低因字段错位导致的签名失败风险。
1、在终端中再次运行：hermes gateway setup。
2、向导中选择平台类型为 dingtalk。
3、输入钉钉开发者后台“应用管理→自建应用→凭证与基础信息”页中的 AppKey 与 AppSecret。
4、填写 AES Key（32位随机字符串，需与钉钉后台“加解密密钥”一致）。
5、设置 Token（与钉钉后台“消息接收设置”中 Token 完全相同）。
四、配置钉钉网关（手动编辑 config.yaml 方式）
该方式支持启用群机器人、自定义回调地址及多企业实例共存，适用于需对接多个钉钉组织的场景。
1、在 ~/.hermes/config.yaml 中定位 gateways 节点。
2、添加 dingtalk 子配置，确保启用开关为 true：enabled: true。
3、app_key 字段填入钉钉应用 AppKey（格式如 dingxxxxyyyyyzzzzz）。
4、app_secret 字段填入对应 AppSecret。
5、token 与 aes_key 必须与钉钉后台“消息接收设置”中配置值逐字匹配，包括大小写与特殊字符。
五、飞书与钉钉事件订阅同步配置
网关配置仅完成服务端准备，平台侧必须完成事件订阅才能触发消息流转。此步骤缺失将导致 Hermes Agent 完全收不到任何用户输入。
1、登录飞书开放平台 → 进入应用详情页 → “事件与回调” → 订阅方式选 长连接 → 添加事件 im.message.receive_v1。
2、登录钉钉开发者后台 → “应用管理” → 找到对应自建应用 → “消息接收” → 启用 事件订阅 → 设置 URL 为 https://你的服务器IP:3000/webhook/dingtalk。
3、钉钉侧需勾选 text 类型消息事件，并确认 Token 与 AES Key 已保存生效。
4、飞书侧若启用加密，需在“事件与回调”中开启 消息加密 并填入 encrypt_key。
5、两个平台均需点击 保存并验证，确保 Hermes Agent 正在运行且端口 3000 可被公网访问。
