飛書
通過飛書與 Hermes Agent 對話。
配置通道 - 飛書
飛書通道適用於辦公場景，支持富文本消息與群聊 @機器人。接入方式與微信一致，使用掃碼授權。
本頁覆蓋
-
在 LightVela 生成飛書接入二維碼
-
使用飛書掃碼授權
-
在飛書中與 Hermes Agent 進行對話
操作步驟
1. 進入管理台
登錄 LightVela，點擊右上角「我的 Hermes」進入管理台，找到「通道 」按鍵。
2. 選擇飛書通道
點擊下拉框，選擇「飛書」。下方顯示飛書通道介紹。
3. 點擊「授權接入」
頁面彈出二維碼。
4. 使用飛書掃碼
手機端：
-
打開飛書
-
點擊右上角「+」→「掃一掃」
-
對準電腦屏幕上的二維碼掃描
-
按提示完成授權
5. 在飛書中查找 Hermes Agent
掃碼成功後：
-
管理台「已接入通道」列表新增"飛書"記錄
-
飛書自動添加機器人至聯繫人
飛書搜索創建的飛書應用名稱
進入該機器人的對話窗口，發送測試消息：
你好
成功狀態
-
管理台「已接入通道」列表中出現"飛書"
-
飛書搜索中可查找到對應機器人
-
發送消息後能收到 Hermes Agent 回覆
支持的消息類型
接入成功後，飛書機器人除了能夠接收、回覆基礎文本信息外，還支持更多消息類型，詳情如下：
| 飛書機器人支持的消息類型和功能 | 是否支持 |
|---|---|
| 接收文本信息 | ✅ 已支持 |
| 接收圖片 | ✅ 已支持 |
| 接收文件 | ✅ 已支持 |
| 接收音頻、視頻 | ✅ 已支持 |
| 回覆文本信息 | ✅ 已支持 |
| 回覆圖片 | ✅ 已支持 |
| 回覆文件 | ✅ 已支持 |
| 回覆音頻 | ✅ 已支持 |
| 回覆內容支持 Markdown 格式 | ✅ 已支持 |
| 主動發送消息（如定時發送提醒） | ✅ 已支持 |
| 操作飛書文檔、Wiki 知識庫、飛書雲盤 | ✅ 已支持 |
常見問題
| 現象 | 可能原因 | 處理方式 |
|---|---|---|
| 掃碼提示"應用未授權" | 飛書租户管理員限制第三方應用 | 聯繫所在租户管理員放行，或改用個人租户 |
| 找不到機器人聯繫人 | 飛書默認摺疊機器人 | 在飛書頂部搜索 Hermes Agent 名稱 |
| 如何將機器人添加至群聊 | — | 在群設置的「添加群成員」中搜索該機器人並添加 |
| 二維碼過期 | 超過有效期未掃碼 | 關閉彈窗，重新點擊「授權接入」 |
| 發送消息後無回覆 | 模型未配置或體驗積分耗盡 | 檢查「當前模型」狀態 |
| 富文本格式渲染異常 | 部分 Markdown 語法飛書不支持 | 純文本對話不受影響 |
通道説明
-
消息類型：支持文本、富文本、圖片、文件、音頻、視頻等多種類型，詳見上方「支持的消息類型」
-
群聊支持：支持將機器人添加至群聊並 @機器人發起對話
-
租户限制：企業飛書下是否支持接入外部機器人取決於租户管理員策略
下一步
- 配置技能 — 擴展 Hermes Agent 能力