阿里云部署的Hermes Agent 如何接入钉钉？

本文由云枢国际yunshuguoji撰写。

前置准备：搞定基础配置

1. 阿里云服务器选购
   登录阿里云轻量应用服务器控制台，选择Hermes Agent 官方镜像，配置遵循 “黄金标准”：
   实例规格：2 核 4GB 及以上（2 核 2GB 易卡顿崩溃）
   磁盘：10GB 以上 SSD，保障记忆数据存储
   地域：国内选华东 1（杭州）、华北 2（北京），延迟更低
   带宽：5Mbps 起步，满足钉钉消息并发交互

2. 绑定百炼大模型 API
   Hermes Agent 需依托大模型实现 AI 能力，阿里云百炼（通义千问）是最优适配选择：
   1.进入服务器 “应用详情” 页，点击 “配置 Hermes”→“初始化配置百炼 API Key”
   2.登录阿里云百炼控制台，创建 API Key（推荐 Coding Plan 套餐，固定月费、额度内无限调用）
   3.填入 API Key 并选择对应地域，完成模型绑定

3. 钉钉开放平台创建应用
   获取钉钉接入凭证，是打通 Hermes 与钉钉的核心前提：
   1.登录钉钉开放平台，进入 “应用开发”→“企业内部开发”→“创建应用”
   2.填写应用名称（如 “Hermes 智能助手”）、图标，选择 “开发模式” 为 “开发应用”
   3.进入 “应用能力”→“机器人”，开启机器人配置，设置名称与头像
   4.在 “凭证与基础信息” 中，记录AppKey、AppSecret、RobotCode（后续配置必备）

一键接入：完成钉钉配置

1. 配置 Hermes 网关（零代码操作）
   1.进入阿里云服务器的 Hermes WebUI，找到 “消息网关”→“钉钉配置”
   2.开启钉钉通道，填入此前获取的 AppKey、AppSecret
   3.设置消息接收地址
   保存配置，重启 Hermes 服务使设置生效

2. 钉钉应用发布与权限配置
   1、返回钉钉开放平台，进入 “权限管理”，添加核心权限：
   oqyapi_get_member_list：获取成员信息
   oqyapi_manage_agent：管理应用
   o群聊消息权限：确保机器人可接收群消息、
   2、完成权限配置后，点击 “发布应用”，选择企业内可见范围
   3、在钉钉工作台搜索应用名称，添加到常用应用，完成接入

3. 测试验证：一键发送消息
   1、在钉钉群聊中 @Hermes 机器人，发送测试指令（如 “你好”“查询今日日程”）
   2、若机器人实时回复，且指令执行正常，即接入成功
   3、支持自定义指令模板、设置自动回复规则，适配企业个性化需求