不会编程用 AI 做飞书机器人：从零到自动回复（2026）

在国内办公协作里，飞书、企业微信、钉钉已经取代了大部分公司内部的微信群。很多团队都想在自己飞书群里放一个机器人——自动回复常见问题、当 7×24 小时智能客服、定时推送日报和数据告警。过去做这件事要写后端、买服务器、搞签名校验，非程序员基本劝退。但现在有了 AI 大模型 + 飞书开放平台，不用写一行代码也能做出一个能聊天的飞书机器人。这篇飞书机器人教程从零开始，把建应用、开权限、接 AI、上线发布一步步讲清楚。

飞书机器人是什么，能干什么

飞书机器人本质上是「飞书开放平台」上的一个企业自建应用，被赋予了机器人能力。它像一个挂在飞书里的员工账号，可以接收你发给它的消息，也可以主动给你或群里发消息。把它和 AI 大模型接起来，它就变成了一个懂业务、能聊天的智能助手。

• 智能客服：把产品文档、FAQ 喂进去，机器人自动回答员工或客户的常见问题
• 群聊答疑：在群里 @ 机器人，它按知识库回答，减轻技术同学被反复问的负担
• 定时推送：每天固定时间把日报、数据看板、告警信息推到群里
• 流程自动化：配合审批、表单、多维表格，做报销提醒、任务通知等

第一步：飞书开放平台建应用（全程点鼠标）

不管后面用哪种接 AI 的方案，飞书开放平台这边的配置都是同一套。用管理员账号登录 open.feishu.cn，按下面顺序点一遍：

1. 1创建应用：点「创建应用」→ 选「企业自建应用」→ 填名字、描述，可传个头像
2. 2添加机器人能力：进应用详情页 →「添加应用能力」→ 勾选「机器人」。不加这一步，应用根本收不到消息
3. 3开通权限：进「权限管理」逐个搜索并开通收发消息所需的权限（见下表）
4. 4记下凭证：在「凭证与基础信息」页拿到 App ID（形如 cli_xxx）和 App Secret，Secret 相当于机器人密码，别泄露
5. 5配置事件订阅：进「事件与回调」→ 添加事件 im.message.receive_v1（接收消息）
6. 6发布版本：进「版本管理与发布」→ 创建版本 → 提交，企业内部管理员审批即可。不发布版本，事件订阅不生效

权限是最容易漏的一步，漏了机器人就「收不到私聊」或「群聊不响应」。需要的核心权限如下：

第二步：接 AI，三种方案按需选

飞书这边的「壳」搭好后，真正让它变聪明的是背后的 AI。这里有三条路线，从最省事到最自由：

方案一：AI Agent 平台一键接入（最省事）

这类平台帮你把「接收飞书消息 → 调大模型 → 回消息」整条链路都封装好了，你只需要填两个凭证。以社区常用的 Hermes Agent 为例：

# 在云服务器上安装 Hermes Agent
curl -fsSL https://hermes-agent.org/install.sh | bash
hermes init            # 配置大模型 API Key
hermes gateway setup   # 选 Feishu，填入 App ID 和 App Secret，连接模式选 WebSocket
hermes start --daemon  # 后台启动

启动后去飞书里搜索你的机器人发条消息，再回服务器执行配对授权（hermes pairing approve <用户ID>），机器人就开始自动回复了。它支持文本、文件、图片、群聊 @、跨会话记忆，还能导入 FAQ 文档做智能客服。也可以用 LangBot + Dify 的组合：LangBot 负责接飞书，Dify 负责编排 AI 回复逻辑，同样可视化配置。

方案二：Python 长连接自建（免费可控）

如果你会一点 Python，用飞书官方 SDK（lark-oapi）写一个长连接机器人非常轻量，本地就能跑，不需要公网服务器。核心思路：建立 WebSocket 长连接 → 监听消息事件 → 把消息内容发给大模型 API → 把回复发回飞书。

pip3 install lark-oapi
# 然后写一个 ws_bot.py：
#   1. 用 App ID / App Secret 建立长连接
#   2. 通过 EventDispatcher 监听 on_p2_message_receive_v1（私聊）和群聊 @ 事件
#   3. 把消息文本 POST 到大模型（DeepSeek/GLM 等 OpenAI 兼容接口）
#   4. 用 client.im().message().create() 把回复发回飞书

方案三：群 Webhook（只推消息，不收消息）

如果你只是想要「每天把日报/告警推到群里」，根本不用建自建应用——在群里添加「自定义机器人」拿到一个 Webhook 地址，用脚本 POST 一条消息即可，配合系统定时任务（cron）就能定时推送。

# 群设置 → 群机器人 → 添加自定义机器人，拿到 webhook 地址
curl -X POST 'https://open.feishu.cn/open-apis/bot/v2/hook/<你的token>' \
  -H 'Content-Type: application/json' \
  -d '{"msg_type":"text","content":{"text":"今日日报已生成，请查收"}}'

六个常见踩坑

1. 1个人版不能用：飞书个人版没有自建应用能力，先建团队版
2. 2漏开 p2p_msg 权限：只开了 im:message 仍收不到私聊，im:message.p2p_msg 要单独开
3. 3忘了发布版本：事件订阅配置完不发布，机器人依旧收不到消息
4. 4长连接不补发：连接建立之前用户发的消息不会补发，先启动服务再测试
5. 5消息超长：飞书单条消息上限约 3 万字符，AI 回复太长要分段发送
6. 6IP 白名单：如果在飞书后台配了 IP 白名单，记得把服务器公网 IP 加进去，否则请求会被 403 拒绝

飞书机器人这件事，真正的门槛从来不在「接飞书」这半小时的配置，而在背后的 AI 能力——知识库怎么搭、提示词怎么写、多轮对话怎么不跑偏。把这些基础打牢，你才能做出真正能用的办公机器人。想系统掌握用 AI 工具做出可交付产品的方法，欢迎来 IMAI 看看我们的实战课程。