飞书接入——一站式协作平台 | Easy Understand Hermes Agent

这篇教程将手把手教你如何把 Hermes Agent 接入飞书或 Lark，让你直接在聊天窗口里指挥 AI 助手。

准备工作：像“配钥匙”一样创建应用

要让 Hermes 在飞书里“安家”，首先得在飞书开放平台创建一个“应用”——你可以把它想象成给机器人配一把专属钥匙。

推荐方式（一条命令搞定）：

hermes gateway setup

选择 Feishu / Lark，然后用飞书手机App扫码，Hermes 会自动帮你创建好应用并配好权限，省心省力。

手动创建（备选方案）：

打开飞书开放平台（https://open.feishu.cn/）或 Lark 国际版控制台
创建一个新应用，在“凭证与基础信息”里找到 App ID 和 App Secret（相当于账号密码）
开启“机器人”能力
在“权限管理”里添加以下权限（可批量导入）：

必选权限：

权限	用途
`im:message`	接收和读取消息
`im:message:send_as_bot`	以机器人身份发消息
`im:resource`	访问用户发的图片、文件
`im:chat`	获取群聊信息

强烈建议加上： im:message.reactions:readonly（接收表情回应）、contact:user.id:readonly（识别用户身份）

在“事件与回调”里订阅 im.message.receive_v1 事件（这是接收消息的“开关”）
发布应用版本——不发布的话权限不会生效哦！

选择连接方式：像选“电话线”还是“对讲机”

WebSocket 模式（推荐）：Hermes 主动连上飞书的服务器，不需要公网地址，适合个人电脑或内网服务器使用。

FEISHU_CONNECTION_MODE=websocket

Webhook 模式：适合已有公网服务器的用户，飞书会把消息“推”到你的服务器上。

FEISHU_CONNECTION_MODE=webhook

配置 Hermes：填写“通讯录”

把以下配置加到 ~/.hermes/.env 文件里：

FEISHU_APP_ID=cli_xxx
FEISHU_APP_SECRET=secret_xxx
FEISHU_DOMAIN=feishu        # 国内版用 feishu，国际版用 lark
FEISHU_CONNECTION_MODE=websocket

# 强烈建议设置以下两项：
FEISHU_ALLOWED_USERS=ou_xxx,ou_yyy   # 允许使用的用户ID白名单
FEISHU_HOME_CHANNEL=oc_xxx           # 接收定时任务结果的群聊ID

启动网关

hermes gateway

然后给机器人发条消息试试，通了就大功告成！

安全设置：给门上把锁

用户白名单：生产环境务必设置 FEISHU_ALLOWED_USERS，否则任何能接触到机器人的人都能使用它。

群聊策略：默认只在被 @ 时回复，可通过 FEISHU_GROUP_POLICY 调整：

allowlist（默认）：只回复白名单用户
open：任何人 @ 都回复
disabled：完全不理会群消息

加密验证（Webhook 模式）：设置 FEISHU_ENCRYPT_KEY 和 FEISHU_VERIFICATION_TOKEN，防止别人伪造消息。

小总结

接入飞书就像给 Hermes 装了个“中国本地电话”——扫码创建应用、配置权限、选择连接方式、设置安全策略，四步就搞定。现在你可以在飞书里直接和 AI 对话了！

下篇预告：我们将探索 Hermes 的“记忆宫殿”——如何配置长期记忆，让 AI 真正“记住”你的偏好和对话历史。