Hermes Agent接入飞书/企业微信：全流程配置与权限优化指南

Feishu 飞书

先进入飞书开放平台（https://open.feishu.cn/?lang=zh-CN），创建企业自建应用是第一步。整个过程其实很直观，跟着界面走就行。

填写应用名称和描述，点击创建——名字最好一眼能看出用途，比如“Hermes助手”之类。

接着给应用添加能力：机器人。这一步打勾就行，别漏了。

权限管理这里稍微有点繁琐，但可以用批量导入功能省点事。把下面这段JSON直接贴进去，一次性搞定所有需要的权限：

{
  "scopes": {
    "tenant": [
      "aily:file:read",
      "aily:file:write",
      "application:application.app_message_stats.overview:readonly",
      "application:application:self_manage",
      "application:bot.menu:write",
      "cardkit:card:write",
      "contact:contact.base:readonly",
      "contact:user.employee_id:readonly",
      "corehr:file:download",
      "docs:document.content:read",
      "event:ip_list",
      "im:chat",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:bot_access",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.group_msg",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource",
      "sheets:spreadsheet",
      "wiki:wiki:readonly"
    ],
    "user": [
      "aily:file:read",
      "aily:file:write",
      "contact:contact.base:readonly",
      "im:chat.access_event.bot_p2p_chat:read"
    ]
  }
}

权限导入完成后，在“凭证与基础信息”里获取 App ID 和 App Secret，这两个值马上要用来配置命令行。

打开终端，输入 hermes gateway setup，选择配置 Feishu。按提示填入 App ID、App Secret 以及自己的 User IDs（User IDs 怎么拿？官方文档讲得很清楚）。Domain 保持默认 feishu，Connection mode 选 websocket 即可。

回到飞书开放平台，进入“事件与回调”，订阅方式选择“长连接”——这样飞书才能实时推送消息给 Hermes。

添加事件 im.message.receive_v1，这是接收消息的入口，不配上这条事件机器人就收不到任何对话。

最后一步，在“版本管理与发布”中发布应用。发布后应用才会对用户生效。

首次在飞书里向这个机器人发消息，它会让用户在命令行运行一条配对命令。照着做就行。

看到 “Approved！配对成功！” 的提示，说明连接已经建立。

再发一条消息测试，一切正常——飞书端配置完成。

WeCom (Enterprise WeChat) 企业微信

企业微信的配置思路类似，但具体操作步骤稍有不同。首先登录企业微信管理后台，进入“管理工具” → “智能机器人”。

点击“创建机器人”，简要描述使用场景后确认创建。

创建完成后，选择“API模式”来配置——这样外部系统（比如 Hermes）才能通过 API 接入。

此时会显示 Bot ID 和 Secret，记下来，马上要用。

同样在命令行运行 hermes gateway setup，这次选择配置 WeCom。依次填入 App ID（即 Bot ID）、App Secret 以及 User IDs。User IDs 怎么找？进入企业微信后台的“通讯录”，点击成员头像进入详情页，页面上显示的“账号”字段就是该成员的 UserID。

回到企业微信管理后台，配置机器人的“可见范围”和“可使用权限”，确保目标用户能访问到机器人，然后点击保存。

打开企业微信客户端，搜索刚刚创建的机器人名称。

在搜索结果中找到并点击“去使用”，就可以开始对话了。

发一条消息测试，响应正常——企业微信的接入也顺利完成了。