我之前写了微信接入指南，很多人问：飞书能接吗？
答案是：能，而且比微信还简单。
今天把飞书机器人接入的完整过程写出来，和微信一样，一步步照着做就行。
## 为什么接飞书？
先说我为什么需要飞书机器人。
我的博客 yhyylm.cn 主要面向技术人员，这群人用飞书的不少。而且飞书有这几个优势：
– 企业级稳定性 — 不像个人微信号，不用担心封号
– 开放API — 官方支持机器人，不需要灰产方案
– 多人协作 — 可以加到群里，多个人共用一个机器人
– 丰富格式 — 支持卡片、表格，比微信纯文本强太多
所以飞书接入，对很多团队来说是刚需。
## 前置准备
在开始之前，你需要：
1. 一个飞书账号 — 个人账号也行，但有企业管理员权限更方便
2. 一台服务器 — 腾讯云轻量2核2G足够（购买链接）
3. QClaw已安装 — 这篇不重复安装步骤
4. 公网IP或域名 — 飞书需要回调你的服务器
## 第一步：创建飞书应用
打开飞书开放平台：open.feishu.cn
1. 点击”开发者后台” → “创建企业自建应用”
2. 填写应用名称，比如”老Q助手”
3. 上传一个头像（可选）
4. 点击”创建”
创建后，你会看到 App ID 和 App Secret，这两个后面要用。
## 第二步：配置权限
在应用后台，进入”权限管理”，开通以下权限：
– im:message（获取与发送单聊、群聊消息）
– im:message:send_as_bot（以应用身份发消息）
– im:chat（获取群组信息）
这些是基础权限，足够做自动回复了。
## 第三步：配置事件订阅
这是最关键的一步：
1. 在应用后台，进入”事件订阅”
2. 填写请求网址：https://你的域名/webhook/feishu
3. 点击”添加事件”，选择：
– im.message.receive_v1（接收消息）
飞书会发送一个验证请求到你的URL，你的服务器需要正确响应。
## 第四步：QClaw配置
在QClaw里配置飞书通道：
“`
openclaw config set channels.feishu.enabled true
openclaw config set channels.feishu.app_id “你的App ID”
openclaw config set channels.feishu.app_secret “你的App Secret”
“`
然后重启Gateway：
“`
openclaw gateway restart
“`
## 第五步：发布应用
回到飞书开放平台：
1. 点击”版本管理与发布”
2. 点击”申请发布”
3. 填写版本说明
4. 等待审核（通常几分钟）
审核通过后，你的飞书机器人就可以用了。
## 实际效果
接入成功后，用户给机器人发消息，QClaw会自动回复。
我测试了几种场景：
– 问QClaw安装方法 → 自动回复教程链接
– 问服务器推荐 → 自动回复腾讯云推广
– 问定时任务配置 → 自动回复踩坑文章
响应速度很快，基本1-2秒就回。
## 踩坑记录
### 坑1：事件订阅验证失败
飞书验证URL时，你的服务器必须返回解密后的challenge字符串。
QClaw已经内置了这个逻辑，但如果你自己实现，要注意飞书的加密算法。
### 坑2：消息发送失败
检查你的机器人是否有”im:message:send_as_bot”权限。
没有这个权限，机器人能收消息但不能回复。
### 坑3：群聊消息收不到
如果机器人加到群里，需要额外配置”im:chat”权限。
而且群聊消息不会触发事件订阅，除非有人@机器人。
## 微信 vs 飞书对比
| 对比项 | 微信 | 飞书 |
|——–|——|——|
| 稳定性 | 中等（有封号风险） | 高（官方支持） |
| 接入难度 | 中（需要扫码登录） | 低（纯API） |
| 消息格式 | 纯文本 | 卡片/富文本 |
| 多人协作 | 不支持 | 支持（群聊） |
| 适用场景 | 个人用户 | 团队/企业 |
## 总结
飞书机器人接入比微信还简单，核心就三步：创建应用 → 配置权限 → 填写回调URL。
如果你面向的是企业用户或者技术团队，飞书接入非常值得做。
有问题评论区交流！