Hermes怎么配置飞书?Hermes配置飞书教程分享

Hermes是可以连接飞书使用的,具体Hermes怎么配置飞书呢?下面就分享Hermes配置飞书的详细教程。

步骤 1:创建自定义机器人

  1. 打开飞书,进入要推送的群聊
  2. 点击右上角「设置」图标
  3. 找到「群机器人」→「添加机器人」
  4. 选择「自定义机器人」

步骤 2:配置机器人信息

填写:

名称: Hermes 测试报告
描述:(可选)自动推送测试报告 头像:上传一个醒目的图标(建议用 Hermes logo)

步骤 3:安全设置(重要!)

有三种安全方式:

方式 优点 缺点 推荐度
不限 配置简单 任何人拿到 URL 都能发消息 :star::star:
IP 白名单 安全性高 需要固定 IP :star::star::star:
签名验证 安全且灵活 需要计算签名 :star::star::star::star::star:

推荐选择「签名验证」,复制「签名密钥」(secret),后面要用。

步骤 4:复制 Webhook URL

格式类似:

https://open.feishu.cn/open-apis/bot/v2/hook/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

:warning: 重要:这个 URL 相当于密码,不要发到公开仓库!


配置 Hermes

编辑配置文件

vim ~/.hermes/config.yaml

添加飞书配置:

飞书推送配置

FEISHU_HOME_CHANNEL: XXX# 你的飞书 channel ID
FEISHU_WEBHOOK_URL:https://open.feishu.cn/open-apis/bot/v2/hook/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
FEISHU_WEBHOOK_SECRET: xxxxxxxxxxxxxxx  # 签名密钥


模型配置

model:
  provider: XXXX
  default: XXXX

:warning: 安全提示:Webhook URL 和 Secret 相当于密码,不要提交到公开仓库!

获取 Channel ID

如果你不知道 channel ID,可以:

  1. 方式 1:在飞书群里发消息,然后查看消息 URL
  2. 方式 2:使用 Hermes 命令查询
  3. 方式 3:直接填 local(推送到本地文件)

感觉都差不多

配置飞书webhook那一步坑最多,token过期要重新授权

按教程一步步走基本没坑,注意token权限就行

webhook那步坑多,飞书自定义机器人的鉴权方式改了好几次

飞书配置步骤比微信简单多了,半小时搞定

Hermes配飞书那步token过期挺烦,建议设置自动刷新

飞书配置踩了个权限坑,webhook地址要填对

我卡在OAuth那步了,飞书的回调地址格式跟文档写的不一样

飞书的webhook配置有没有需要注意的

飞书webhook那步容易出错,记得权限要手动勾选消息读写

飞书webhook对接Hermes流程其实挺直观的

配置飞书webhook那一步坑最多,token过期要重新授权

权限那个我也踩了,还得在飞书后台开API

webhook那步token过期是常见,配自动刷新机制省心