飞书机器人Hermes Agent配置指南：提升团队效率的实战教程

2026-05-17阅读 0热度 0

机器人

为团队部署一个能自动响应消息、处理任务的智能助手？将 Hermes Agent 集成到飞书，是构建此类自动化工作流的高效方案。整个过程聚焦于飞书开放平台的配置与 Hermes 服务端的适配，以下六个步骤将引导你完成部署。

一、在飞书开放平台创建企业自建应用

首先，为你的智能助手建立一个合法身份。前往飞书开放平台创建一个“企业自建应用”，这相当于为 Hermes Agent 获取官方接入凭证。只有通过此方式创建的应用，才能被系统正确识别与绑定。

操作流程：访问 https://open.feishu.cn，使用管理员账号登录。点击右上角「创建应用」，选择「企业自建应用」。填写应用名称（例如“Hermes AI 助手”）、描述并上传图标，最后点击「创建」完成。

二、启用机器人能力并配置权限

创建应用后，需激活其核心能力。启用机器人功能是赋予应用消息收发能力的基础。精确配置权限则定义了 Hermes Agent 的操作范围，例如读取消息、发送回复或获取用户信息。

进入应用详情页，在「应用功能」中找到「机器人」，点击「启用机器人」。关键一步：务必勾选「开启交互式卡片」选项，以确保后续的按钮点击、表单提交等高级交互功能可用。

随后，前往「权限管理」→「申请权限」，添加以下核心权限：
• im:message:send_as_bot（以机器人身份发送消息）
• im:message:read（读取接收到的消息）
• contact:user:readonly（读取用户基本信息）
• im:message.group_at_msg:readonly（接收群聊中@机器人的消息）

添加完成后，点击「保存」并执行「发布」，使权限生效。

三、获取并记录应用凭证

接下来，获取应用的核心身份凭证——App ID 和 App Secret。这两组字符串是 Hermes Agent 与飞书平台建立安全通信、进行身份验证的关键，后续所有配置步骤都依赖它们。

在应用详情页左侧菜单，点击「凭证与基础信息」。复制并妥善保存 App ID（格式如 cli_xxxxxxxxxx）和 App Secret（一串随机字符）。注意：App Secret 属于敏感信息，切勿泄露至公开代码库或聊天记录中。

四、配置 Hermes Gateway 接入飞书通道

获得凭证后，需将 Hermes Agent 实例与飞书应用进行逻辑绑定。通常有两种配置方式：交互式向导或手动编辑配置文件。

方式一：使用交互式向导（推荐新手）
在运行 Hermes Agent 的服务器终端，执行命令：hermes gateway setup。跟随提示操作：选择 feishu → 输入已保存的 App ID 和 App Secret → User IDs 可留空（允许全员访问）或填入特定测试用户ID → Domain 保持默认 feishu → Connection mode 选择 websocket。

方式二：手动编辑配置文件（适合熟悉YAML的用户）
打开配置文件：~/.hermes/config.yaml。在 gateways 部分下，按正确缩进格式添加如下内容：

feishu:
  enabled: true
  app_id: "cli_xxxxxxxxxx"
  app_secret: "xxxxxxxxxxxxxxx"
  verification_token: "your_verification_token"
  encrypt_key: "your_encrypt_key"

五、配置事件订阅与回调地址

绑定完成后，需配置事件订阅机制，使飞书能将用户消息事件主动推送给 Hermes Agent。这确保了机器人能实时响应交互。

返回飞书开放平台的应用详情页，进入「事件与回调」→「事件订阅」。订阅方式建议选择「长连接」，以获得更稳定的连接。若选择「HTTP 回调」，则需填写一个公网可访问的 HTTPS URL，例如：https://你的服务器IP:3000/webhook/feishu。

在「需要订阅的事件」中，至少确保勾选：im.message.receive_v1（接收消息事件）。保存后，飞书会向你的回调地址发送验证请求，请确认 Hermes Agent 服务正在运行并监听正确路径。

六、发布应用并完成测试

后台配置现已就绪。但未发布的应用仅限开发者调试，需发布后才能供团队成员使用。

在飞书开放平台找到「版本管理与发布」，点击「创建版本」，填写版本说明后提交审核。等待团队管理员在飞书客户端审批通过。

发布成功后，团队成员即可在飞书中搜索到应用名称并点击「添加」。现在，可在私聊或群聊中@机器人或发送消息进行测试。观察 Hermes Agent 是否返回预期响应。若无反应，请检查服务端日志，查找 feishu webhook received 接收记录或 connection refused 等连接错误，并据此排查问题。

完成这六步，一个能理解上下文、自动响应的智能飞书机器人便部署成功。通过深度集成，它不仅能处理问答，更能驱动工作流、查询数据，成为提升团队生产力的核心工具。