需分别完成飞书与钉钉平台的应用创建、权限配置、凭证获取及网关绑定：飞书支持WebSocket长连接（企业自建应用）与环境变量注入两种方式；钉钉支持可信IP+加解密（企业内部应用）与YAML直写配置两种方式；双平台配置完成后须验证消息响应、状态激活及日志分离。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望将 Hermes Agent 部署为可在飞书或钉钉中直接响应消息的企业办公助理，但尚未完成任一平台的对接，则需分别完成平台应用创建、权限配置、凭证获取与网关绑定等关键环节。以下是针对飞书与钉钉两个平台的独立、可并行执行的集成路径：
一、飞书平台集成（企业自建应用方式）
此方式通过飞书开放平台注册合法机器人身份，利用 WebSocket 长连接实现低延迟双向通信，无需公网回调地址，适合无固定域名或NAT环境下的部署场景。
1、访问 https://open.feishu.cn，使用具有企业管理员权限的飞书账号登录。
2、进入「应用开发」→「企业自建应用」→ 点击「创建应用」，填写应用名称（如“Hermes 办公助理”）及描述，完成创建。
3、在应用详情页，点击「应用能力」→「机器人」→ 开启机器人功能，务必勾选「开启交互式卡片」选项。
4、进入「权限管理」，添加以下权限：im:message:send_as_bot、im:message:read、im:message.group_at_msg:readonly、contact:user.id:readonly、im:resource。
5、进入「事件与回调」→ 选择「WebSocket 长连接模式」→ 订阅事件类型 im.message.receive_v1 → 保存并发布应用。
6、在「凭证与基础信息」页面，完整复制 App ID 与 App Secret（App Secret 仅显示一次，丢失需重置）。
二、飞书平台集成（环境变量注入方式）
该方式绕过交互式向导，直接通过系统级环境变量注入飞书凭证，适用于容器化部署、CI/CD 流水线或需批量管理多租户实例的场景，避免配置文件硬编码风险。
1、在 Linux/macOS 服务器上执行以下命令设置环境变量：
export FEISHU_APP_ID=cli_xxxxxxxxxxxxxx
export FEISHU_APP_SECRET=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
2、确保环境变量在 Hermes Agent 启动时生效，例如在 systemd service 文件中添加 EnvironmentFile 或在启动脚本中 source 配置。
3、验证变量已加载：运行 echo $FEISHU_APP_ID，确认输出非空。
4、重启 Hermes Agent 进程，使其自动识别飞书网关启用状态。
三、钉钉平台集成（企业内部应用方式）
此方式基于钉钉开放平台创建企业内部应用，通过配置可信IP与加解密密钥保障消息传输安全，适用于已具备公网IP且需严格审计消息链路的企业环境。
1、登录钉钉开放平台（https://open.dingtalk.com），进入「应用开发」→「企业内部应用」→「创建应用」。
2、填写应用名称（如“Hermes 钉钉助手”）、应用描述及图标，完成创建。
3、进入「应用功能」→「机器人」→ 开启机器人开关，记录生成的 Webhook 地址（含 access_token 参数）。
4、进入「开发管理」→「API调用」→ 添加可信 IP，填入 Hermes Agent 所在服务器的公网 IPv4 地址。
5、在「开发管理」→「消息接收」中，启用「加密消息」选项，记录 Token 与 AES Key。
6、获取应用凭证：Client ID 与 Client Secret，位于「应用基本信息」页底部。
四、钉钉平台集成（配置文件直写方式）
该方式通过手动编辑 Hermes Agent 的 YAML 配置文件，显式声明钉钉网关参数，便于版本控制、灰度发布与多环境差异化配置。
1、打开配置文件：~/.hermes/config.yaml。
2、在 gateways 节点下新增钉钉配置段：
dingtalk:
enabled: true
client_id: "your-client-id-here"
client_secret: "your-client-secret-here"
token: "your-token-here"
aes_key: "your-aes-key-here"
3、保存文件后执行 hermes gateway reload 命令触发热重载。
4、检查日志输出是否出现 "DingTalk gateway initialized successfully" 提示。
五、双平台协同启用验证
当飞书与钉钉各自完成配置后，Hermes Agent 将同时监听两个平台的消息事件；此时需统一校验用户身份映射与消息路由一致性，防止跨平台会话混淆。
1、在飞书中搜索已创建的机器人名称，发送测试消息 “你好”，观察是否返回响应。
2、在钉钉工作台中找到对应应用图标，点击进入并发送相同消息，确认响应内容一致且上下文隔离。
3、执行命令 hermes gateway status，查看输出中 feishu 和 dingtalk 状态均为 active。
4、检查日志目录 ~/.hermes/logs/gateway/ 下是否存在 feishu.log 与 dingtalk.log 两个独立文件，且均有实时写入记录。
