Hermes Agent 接入飞书钉钉：企业IM平台接入指南-China AI Hub

维护咨询大模型部署问题解决技能定制大模型训练

站长交流微信: aixbwz

飞书和钉钉是国内最常用的企业协作平台，把 Hermes Agent 接入它们，可以在工作群里直接调用 AI 助手，大幅提升团队效率。

为什么接入飞书/钉钉

不用打开额外工具，在工作群里直接用
团队成员都能用，统一入口
适合运营、客服、内容等部门

接入飞书

第一步：创建飞书企业自建应用

1. 打开 https://open.feishu.cn/app
2. 点击「创建企业自建应用」
3. 填写应用名称和描述
4. 创建后进入应用设置页面
5. 在「凭证与基础信息」中找到：
   - App ID
   - App Secret

第二步：配置权限

在飞书应用后台：
1. 进入「权限管理」
2. 开通以下权限：
   - im:message（发消息）
   - im:message.group_at_msg（接收群消息）
3. 发布应用

第三步：配置 Hermes Gateway

# 编辑 ~/.hermes/config.yaml
gateway:
  enabled: true
  platform: feishu

  feishu:
    app_id: cli_xxxxx
    app_secret: xxxxxxxxxxxxxx
    bot_name: Herme

第四步：启动

hermes gateway

# 看到以下输出说明成功：
# Gateway started
# Feishu bot is listening...

第五步：在飞书群里添加 Bot

1. 打开目标群聊
2. 点击设置 → 群机器人
3. 点击「添加机器人」
4. 选择你创建的自建应用
5. 开始使用

接入钉钉

第一步：创建钉钉应用

1. 登录 https://open.dingtalk.com
2. 进入「应用开发」→「钉钉应用」
3. 点击「创建应用」
4. 选择「企业内部应用」
5. 填写应用信息
6. 在「基础信息」中找到：
   - App Key
   - App Secret

第二步：配置 Hermes

# 编辑 ~/.hermes/config.yaml
gateway:
  enabled: true
  platform: dingtalk

  dingtalk:
    app_key: ding_xxxxx
    app_secret: xxxxxxxxxxxxxx

第三步：启动

hermes gateway

# 钉钉机器人需要公网可达
# 如果在本地机器，需要用 ngrok 或内网穿透

内网穿透（本地部署用户）

# 安装 ngrok
# https://ngrok.com/download

# 注册并获取 authtoken
ngrok config add-authtoken 你的token

# 启动穿透
ngrok http 18789

# 会得到一个公网地址，比如：
# https://abc123.ngrok.io

# 把这个地址填入钉钉后台：
# 应用开发 → 企业内部开发 → 你的应用 → 消息订阅
# 填入消息接收地址

使用示例

接入后，群里所有成员都可以使用：

@Hermes 帮我写一条推广文案
@Hermes 分析一下这份销售数据
@Hermes 翻译这段英文

权限控制

# 可配置哪些人可以使用
gateway:
  feishu:
    allowed_users:
      - 用户ID1
      - 用户ID2
    allowed_groups:
      - 群ID1

常见问题

Q：飞书和钉钉可以同时接入吗？
可以，配置多个 platform 即可。

Q：需要服务器吗？
本地机器可以用 ngrok 穿透，但生产环境建议用服务器。

Q：免费吗？
飞书和钉钉的企业自建应用都是免费的。

Hermes Agent 接入飞书钉钉：企业IM平台接入指南