
## 概述

云上 Hermes Agent 如何接入飞书？腾讯云 Lighthouse 提供可视化配置面板，仅需扫码即可极简接入，适用于办公场景，支持富文本消息与群聊 @机器人。

如果你还不了解 Hermes Agent，或尚未在 Lighthouse 中部署 Hermes Agent，建议先参考 [《玩转 Hermes Agent｜使用 Lighthouse 快速部署云上 Hermes Agent》](https://cloud.tencent.com/developer/article/2653159) 完成部署。本文聚焦"部署完成后如何把飞书接进来"。

---

## 前置准备

在开始之前，请依次确认以下事项：

- 你拥有一个飞书账号（建议使用个人租户或拥有应用发布审批权限的企业租户）
    
- 你已在腾讯云 Lighthouse 中部署 Hermes Agent。如果尚未部署，参考 [《使用 Lighthouse 快速部署云上 Hermes Agent》](https://cloud.tencent.com/developer/article/2653159)
    
- 你已在 Hermes Agent 配置面板中完成**模型（Models）**配置。若尚未配置，参考总教程的 [「步骤二：配置模型」](https://cloud.tencent.com/developer/article/2653159)
    

> 云上 Hermes Agent 接入飞书场景推荐使用国内地域的 Lighthouse 实例与国内模型服务。

---

## 接入飞书

飞书通道与微信通道一样，采用扫码方式一键完成接入与机器人创建，整个流程通常 1–2 分钟即可完成，无需手动创建飞书企业自建应用、无需配置 AppID / AppSecret。

### 1. 进入 Hermes Agent 配置面板

登录 [腾讯云 Lighthouse 控制台](https://console.cloud.tencent.com/lighthouse)，找到已部署 Hermes Agent 的实例，单击实例卡片任意空白处进入实例详情页，在顶部导航中切换到**应用管理**页。

此时你会看到 Hermes Agent 配置面板，从左到右依次是：模型（Models）、通道（Channels）、技能（Skills）三个卡片。

> ⚠️ 如果应用管理页展示的只是"应用内软件信息"（Hermes Agent 版本号、官方文档链接），说明当前应用模板版本较旧，未集成可视化配置面板。需要通过"重装系统"选择最新的 Hermes Agent 应用模板升级，具体参考总教程的 [「方式二：重装一台现有的 Lighthouse」](https://cloud.tencent.com/developer/article/2653159)。重装会清空服务器内数据，如有重要内容请先备份。

### 2. 选择飞书通道

在**通道（Channels）**卡片的下拉框中选择「飞书」，下方显示飞书通道介绍。

### 3. 点击「授权接入」

卡片中弹出飞书扫码二维码。
![Clipboard_Screenshot_1777117196.png](https://developer.qcloudimg.com/http-save/yehe-11556714/f36866e626db01afa2f06ce676a5272a.png)

> ⚠️ **二维码有时效**
>
> 二维码几分钟后会自动失效。若已过期，关闭弹窗重新单击「授权接入」即可生成新二维码。

### 4. 使用飞书扫码授权

1. 打开手机飞书
    
2. 点击右上角「+」→「扫一扫」
    
3. 对准电脑屏幕上的二维码扫描
    
4. 飞书弹出授权页面，选择「立即创建」
    
![Clipboard_Screenshot_1777117267.png](https://developer.qcloudimg.com/http-save/yehe-11556714/9a26a3ddf6f87364ea3c96ef1765492a.png)
完成登录后，返回 Hermes Agent 配置面板，单击弹窗中的「我已完成扫码」。

### 5. 飞书机器人自动创建并配置

扫码确认后，Hermes Agent 会在你的飞书租户下自动完成一系列操作：

- 创建一个应用
    
- 为应用添加机器人能力
    
- 配置事件订阅（长连接接收消息事件）
    
- 批量导入所需权限（发送消息、读取消息、操作飞书文档 / Wiki / 云盘等）
    
- 发布应用版本
    

整个过程约 10–30 秒，完成后面板弹出**「飞书机器人授权配置成功」**提示，**「已接入通道」**列表中新增一条"飞书"记录。

> ⚠️ **如果你没有发布飞书应用的权限**
>
> 扫码后可能会提示**「飞书机器人发布失败 - 当前用户权限无法免审批发布飞书机器人，请联系管理员审批通过后再进行手动配置」**。
>
> **解决办法：**
>
> - 如果你不是所属组织 / 公司的飞书管理员：请联系管理员进行审核，在 [飞书企业管理后台](https://www.feishu.cn/admin) 的**工作台 → 应用审核**中通过该应用
>
> - 如果你是管理员：进入 [飞书企业管理后台](https://www.feishu.cn/admin) → 工作台 → 应用审核，在右侧应用列表中找到待审核的应用单击「审核」并通过。若希望后续自动放行，可在同页面单击「设置审核规则」开启「全员免审」
>
> 管理员审核通过后，回到 Hermes Agent 配置面板重新单击「授权接入」并扫码即可完成接入。

### 6. 在飞书中查找并对话

扫码成功后，飞书会自动将机器人添加至你的联系人。在飞书顶部搜索栏输入机器人名称即可找到，进入对话窗口发送测试消息：

```
你好，请做一下自我介绍
```

如果一切正常，几秒内即可收到 Hermes Agent 的 AI 回复，说明飞书通道已经接入成功。
![Clipboard_Screenshot_1777117346.png](https://developer.qcloudimg.com/http-save/yehe-11556714/a221e7b3c44b75d014092ac936b817c8.png)

---

## 成功状态

- Hermes Agent 配置面板的「已接入通道」列表中出现"飞书"记录
    
- 飞书搜索中能查找到对应机器人
    
- 发送消息后能收到 AI 方式的回复
    

---

## 添加到群聊

机器人默认会与你 1 对 1 私聊。如需在群组中使用：

1. 进入目标群组
    
2. 点击右上角**设置** → **群机器人** → **添加机器人**
    
3. 在搜索框中输入机器人名称
    
4. 选中后单击**添加**
    

群聊中直接 **@机器人** 即可发起对话。

> ℹ️ **仅限同企业群**
>
> 机器人只能被添加到**同一飞书企业 / 租户下**的群聊，无法加入外部群。

---

## 支持的消息类型

接入成功后，飞书机器人除了能够接收、回复基础文本信息外，还支持更多消息类型，详情如下：

| 飞书机器人支持的消息类型和功能 | 是否支持 |
| --- | --- |
| 接收文本信息 | ✅ 已支持 |
| 接收图片 | ✅ 已支持 |
| 接收文件 | ✅ 已支持 |
| 接收音频、视频 | ✅ 已支持 |
| 回复文本信息 | ✅ 已支持 |
| 回复图片 | ✅ 已支持 |
| 回复文件 | ✅ 已支持 |
| 回复音频 | ✅ 已支持 |
| 回复内容支持 Markdown 格式 | ✅ 已支持 |
| 主动发送消息（如定时发送提醒） | ✅ 已支持 |
| 操作飞书文档、Wiki 知识库、飞书云盘 | ✅ 已支持 |

> ℹ️ **实际处理能力取决于模型**
>
> 上表仅代表飞书机器人在消息通道层面支持接收、回复的类型。能否实际完成处理图片、文件、操作飞书文档等任务，还取决于 Hermes Agent 所接入的大语言模型是否具备对应的处理能力。例如要让 Hermes Agent 分析图片，需要配置支持图片理解的多模态模型；要让 Hermes Agent 读写飞书文档，需要配置具备工具调用能力的模型。

---

## 通道说明

- **消息类型**：支持文本、富文本、图片、文件、音频、视频等多种类型，详见上方「支持的消息类型」
    
- **群聊支持**：支持将机器人加入群聊并 @机器人发起对话
    
- **飞书能力集成**：机器人开箱即用地支持浏览/创建飞书文档、Wiki 知识库节点、云盘文件等（具体能否成功调用取决于所配置的模型能力）
    
- **租户限制**：企业飞书下是否支持接入外部机器人取决于租户管理员策略
    

---

## 常见问题

| 现象 | 可能原因 | 处理方式 |
| --- | --- | --- |
| 扫码提示"应用未授权" | 飞书租户管理员限制第三方应用 | 联系所属租户管理员放行，或改用个人租户 |
| 扫码后提示"飞书机器人发布失败" | 当前账号无免审批发布权限 | 参考上文「如果你没有发布飞书应用的权限」小节由管理员审批通过 |
| 找不到机器人联系人 | 飞书默认折叠机器人消息 | 在飞书顶部搜索框中搜索机器人名称 |
| 如何将机器人添加至群聊 | — | 进入群设置 → 群机器人 → 添加机器人，搜索并选中该机器人 |
| 二维码过期 | 超过有效期未扫码 | 关闭弹窗，重新单击「授权接入」 |
| 发送消息后无回复 | 模型未配置或模型服务账户余额不足 | 进入配置面板「模型」卡片，检查「当前模型」状态；登录模型服务商控制台确认余额 |
| 富文本格式渲染异常 | 部分 Markdown 语法飞书不支持 | 以纯文本方式对话不受影响；复杂富文本建议在飞书文档中查看 |
| 对话报错 HTTP 401 / InvalidAuthentication | **模型** API Key 错误，与飞书通道无关 | 回到「模型」卡片检查 API Key、区分 Coding Plan 与普通 API、区分国内版与国际版 |

---

## 更多教程

更多云上 Hermes Agent 实践教程，如一键部署 Hermes Agent、配置模型、接入微信/QQ、安装并使用技能（Skills）等，欢迎查看 [Hermes Agent 部署总教程](https://cloud.tencent.com/developer/article/2653159)。

云上 Hermes Agent 如何接入飞书？腾讯云 Lighthouse 提供可视化配置面板，仅需扫码即可极简接入，适用于办公场景，支持富文本消息与群聊 @机器人。

玩转 Hermes Agent｜云上 Hermes Agent 快速接入飞书指南

云上 Hermes Agent 如何接入飞书？腾讯云 Lighthouse 提供可视化配置面板，仅需扫码即可极简接入。

云计算

人工智能

开发工具

腾讯云Lighthouse提供极简方式接入飞书机器人，通过可视化面板扫码1分钟完成配置，支持富文本消息、群聊@机器人等功能。无需手动创建应用，自动配置事件订阅和权限，适用于办公场景。

4核4G3M云服务器 新用户低至38元/年！

lighthouse

2026采购季 | AI焕新·智启新局

lexiang

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云AI代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

功能1上新10个字符

功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符。

功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符。

功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符

功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符

功能4上新

文章&问答评论现已支持表情

全新交互，全新视觉，新增快捷键、悬浮工具栏、高亮块等功能并同时优化现有功能，全面提升创作效率和体验

社区富文本编辑器全新改版！诚邀体验～ 

精选全网热门MCP server，让你的AI更好用 🚀

💥开发者 MCP广场重磅上线！

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

玩转 Hermes Agent｜云上 Hermes Agent 快速接入飞书指南-腾讯云开发者社区-腾讯云

玩转 Hermes Agent｜云上 Hermes Agent 快速接入飞书指南

玩转 Hermes Agent｜云上 Hermes Agent 快速接入飞书指南

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐