Hermes 配置网关（接入飞书）

为什么是飞书

截至2026年6月24日，Hermes官方文档表示，消息网关兼容性最佳的国内平台只有飞书。

配置网关

Hermes网关配置

在Hermes的控制台（容器的话，直接进入容器内部使用/bin/bash即可）执行命令：

1	hermes gateway setup

PS：如果你的设备性能较差，可能需要耐心等待。

根据引导选择feishu/Lark（键盘↑和↓切换，回车选中）
使用飞书APP扫描授权（基本上自动完成配置）。

飞书开放平台配置

上一步完成后，在飞书开放平台（网页端），你可以看到你的应用（机器人/智能体），你可以进行一些配置并发布。

PS：如果需要企业外用户访问，你需要在发布时，选中对应的选项（需要实名认证）。

授权用户

如果你在Hermes网关配置中，设置feishu网关时，选择了开启配对审批，如下：

How should direct messages be authorized?
  ↑↓ navigate  ENTER/SPACE select  ESC cancel

 → (●) Use DM pairing approval (recommended)
   (○) Allow all direct messages
   (○) Only allow listed user IDs

那么你需要使用飞书APP向你的Hermes/智能体发送一条任意消息（私发），智能体会回复你如下信息：

Hi~ I don't recognize you yet!

Here's your pairing code: YB89GJX6

Ask the bot owner to run:
hermes pairing approve feishu YB89GJX6

你需要在Hermes控制台执行hermes pairing approve feishu YB89GJX6来审批，此后该用户即可正常使用。

问题排查

Q：飞书中Markdown渲染异常

A：Hermes飞书适配器适配不完整，检测到表格会回退为普通信息，可以自行参考飞书官方文档修改适配器

富文本（Markdown）- 开发文档 - 飞书开放平台：https://open.feishu.cn/document/feishu-cards/card-json-v2-components/content-components/rich-text

Q：hermes gateway setup 配置完飞书后发送信息给智能体无反应

A：如果没有重启网关，那么使用hermes gateway restart重启，如果重启过了，那么检查网关的日志，hermes的容器目前没有封装飞书的依赖，因此无法使用，可以在容器内运行以下命令：

1 2	source /opt/hermes/.venv/bin/activate uv pip install --python /opt/hermes/.venv/bin/python 'hermes-agent[feishu]'

随后重启容器