📱 飞书接入教程
5分钟配置飞书机器人，让 AI 助理进入你的工作流
📋 准备工作
✓ 已安装 OpenClaw 并启动 Gateway
✓ 有飞书账号（企业版或个人版均可）
✓ 有创建应用的权限（企业管理员或开发者）
🚀 配置步骤
1
创建飞书应用
- 访问 飞书开放平台
- 点击「创建企业自建应用」
- 填写应用名称（如 "AI 助手"）
- 选择应用图标
- 点击「创建」
2
添加机器人能力
- 进入应用 → 点击「添加应用能力」
- 选择「机器人」
- 点击「添加」
3
配置权限（一键导入）
- 在左侧导航栏找到「权限管理」，点击进入
- 点击右上角「批量导入权限」按钮
- 复制以下 JSON 代码，粘贴到导入窗口中：
{
"scopes": {
"tenant": [
"contact:user.base:readonly",
"im:chat",
"im:chat:read",
"im:chat:update",
"im:message",
"im:message.group_at_msg:readonly",
"im:message.p2p_msg:readonly",
"im:message:send_as_bot",
"im:resource"
],
"user": []
}
}- 点击「导入」，等待权限导入完成
💡 使用批量导入比逐个开通权限更快捷，不容易遗漏
4
配置事件订阅（关键！）
- 在左侧导航栏找到「事件与回调」，点击进入
- 在「事件配置」中，订阅方式选择「使用长连接接收事件」
- 点击「添加事件」按钮
- 在弹出的事件列表中，选择「消息与群组」分类
- 勾选「接收消息」(im.message.receive_v1)
- 点击「确定」完成事件订阅
⚠️ 必须选择「长连接」模式！这样无需公网 IP，OpenClaw 可以主动连接飞书服务器接收消息。
💡 如果提示「未建立长连接」，说明 OpenClaw 还未配置好凭证或 Gateway 未启动，请先完成后续配置步骤。
5
获取凭证
进入「凭证与基础信息」，记下：
- App ID：
cli_xxxxxxxx - App Secret：点击查看并复制
6
发布应用
- 进入「版本管理与发布」
- 点击「创建版本」
- 填写版本信息
- 点击「申请上线」
- 等待管理员审批（或自己审批）
7
在 OpenClaw 管理页面配置
- 打开 OpenClaw 管理页面（默认
http://127.0.0.1:18789） - 点击左侧菜单「Channels」
- 找到「Feishu」渠道，点击配置
- 填入刚才获取的 App ID 和 App Secret
- 点击「Save」保存
💡 官方插件支持在管理页面直接配置，无需手动编辑配置文件
8
保存并等待连接
点击「Save」后，系统会自动连接飞书服务器。
稍等几秒，查看状态是否显示「Connected」或「已连接」。
💡 如果状态异常，可以尝试点击管理页面的「Restart」按钮重新连接
9
测试对话
在飞书中搜索你的机器人，发送一条消息试试！
你好
你好！我是你的 AI 助手，有什么可以帮你的吗？
👥 群聊使用说明
在群聊中，机器人默认只在以下情况回复：
- 被 @ 时
- 消息以 问号 结尾
- 消息包含 求助词（帮、请、怎么、如何...）
这样可以避免机器人刷屏。
❓ 常见问题
Q: 机器人收不到消息？
检查：
- 应用是否已发布上线（不是草稿状态）
- 事件订阅是否选择了「长连接」
- 权限是否都已开通
- Gateway 日志是否显示
logged in to feishu
Q: 群聊不回复？
在群聊中 @机器人，或在消息末尾加个问号。
Q: 如何查看状态？
moltbot channels status feishu