## 最终效果

- 在飞书中 @你的机器人或私聊发消息
- Hermes Agent 自动回复
- 支持文本、文件、图片等多种消息类型
- 跨会话记忆持续生效

## 详细步骤

### 步骤 1：登录飞书开放平台

访问 https://open.feishu.cn ，使用管理员账号登录。

### 步骤 2：创建企业自建应用

1. 点击"创建应用" → 选择"企业自建应用"
2. 填写应用名称（如"Hermes AI 助手"）
3. 填写应用描述
4. 上传应用图标（可选）

### 步骤 3：添加机器人能力

在应用详情页 → "添加应用能力" → 选择"机器人"。

### 步骤 4：配置权限

进入"权限管理"，开通以下权限：
- `im:message`：收发消息
- `im:message.group_at_msg`：接收群@消息
- `im:message.p2p_msg`：接收私聊消息
- `contact:user.id:readonly`：读取用户 ID

### 步骤 5：获取凭证

在"凭证与基础信息"页面记录：
- **App ID**：`cli_xxxxxxxxxx`
- **App Secret**：`xxxxxxxxxxxxxxx`

### 步骤 6：配置事件订阅

1. 进入"事件订阅"
2. 请求网址 URL：`https://你的服务器IP:3000/webhook/feishu`
3. 添加事件：
   - `im.message.receive_v1`（接收消息）
4. 系统会发送验证请求——确保你的 Hermes Agent 正在运行

### 步骤 7：在 Hermes 中配置

```bash
hermes gateway setup
# 或手动编辑 ~/.hermes/config.yaml
```

```yaml
gateways:
  feishu:
    enabled: true
    app_id: "cli_xxxxxxxxxx"
    app_secret: "xxxxxxxxxxxxxxx"
    verification_token: "xxxxx"
    encrypt_key: "xxxxx"  # 如果启用了加密
```

### 步骤 8：发布应用

1. 在飞书开放平台 → "版本管理与发布"
2. 创建版本 → 提交审核
3. 管理员审批后生效

### 步骤 9：测试

在飞书中搜索你的机器人名称，发送一条测试消息。

## 高级配置

### 群聊 @机器人

默认情况下，机器人在群聊中只响应 @它的消息：

```yaml
gateways:
  feishu:
    group_at_only: true  # 群聊中只响应 @消息
```

### 富文本消息

Hermes Agent 会自动将回复转换为飞书支持的富文本格式，包括代码块高亮、列表等。

### 卡片消息

支持发送飞书互动卡片，用于展示结构化信息。

## 部署建议

飞书机器人需要你的服务器有公网可访问的 Webhook 地址。推荐在腾讯云 Lighthouse 上部署：[玩转 Hermes Agent｜使用 Lighthouse 快速部署云上 Hermes Agent](https://cloud.tencent.com/developer/article/2653159)。

---

## 🚀 快速上手 Hermes Agent：仅需三步轻松安装

想要体验 Hermes Agent 的强大能力？推荐在腾讯云上部署，仅需三步即可开始使用：

> **第一步**：购买云服务器 → **第二步**：一键安装 Hermes Agent → **第三步**：接入消息平台，开始使用

腾讯云为 Hermes Agent 用户提供专属优惠云服务器方案，最低2核4G配置即可流畅运行，7×24 小时在线，随时随地通过手机与你的 AI 智能体互动。

👉 **[立即前往腾讯云官网选购 Hermes Agent 专属云服务器](https://cloud.tencent.com/act/pro/hermesagent)**

---

**FAQ：**

**Q1：飞书个人版可以用吗？**
A：飞书机器人需要企业版或团队版。个人版用户可以考虑用 Telegram 替代。

**Q2：Webhook URL 必须是 HTTPS 吗？**
A：飞书强烈建议使用 HTTPS，部分功能要求 HTTPS。可以用 Nginx + Let's Encrypt 免费实现。

**Q3：飞书消息有长度限制吗？**
A：飞书单条消息最大支持 30,000 字符。超长内容 Hermes Agent 会自动分段发送。


请求网址 URL：https://你的服务器IP:3000/webhook/feishu

Hermes Agent 接入飞书机器人：从创建应用到消息互通全流程

飞书是国内使用最广泛的企业办公平台之一，Hermes Agent 原生支持飞书接入。本文提供从零开始的完整教程——创建飞书应用、配置权限、设置事件订阅、连接 Hermes Agent，每一步都有截图级详细说明。

开发工具

网络与通信

后端

飞书机器人HermesAgent配置教程：9步完成企业自建应用创建，支持文本、文件、图片自动回复，实现跨会话记忆。详细讲解权限配置、事件订阅、Webhook设置等关键步骤，提供腾讯云部署建议和常见问题解答，助您快速搭建智能客服系统。

云服务器

服务器

智能体

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

lighthouse

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

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

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

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

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

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

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

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

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

社区新版编辑器体验调研

Hermes Agent 接入飞书机器人：从创建应用到消息互通全流程-腾讯云开发者社区-腾讯云

Hermes Agent 接入飞书机器人：从创建应用到消息互通全流程

Hermes Agent 接入飞书机器人：从创建应用到消息互通全流程

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐