如果你每天都在飞书群里工作，OpenClaw 这个强大的 AI Agent 框架却只能在另一个窗口里运行，那就太浪费了。本指南手把手教你把 OpenClaw 接入飞书，让你在工作群里直接 @AI 助手，帮你生成文档、查数据、处理例行任务，效率直接翻倍。
为什么要把 OpenClaw 接入飞书
场景 1：快速辅助决策 — 产品经理在飞书会议群里需要查用户反馈数据，直接 @OpenClaw Agent，它能从数据库秒速抽取数据，生成摘要，整个过程在群里完成，不打断会议流程。
场景 2：自动化日常任务 — 每周一在飞书输入”生成上周的项目周报”，Agent 自动收集代码 commit、BUG 修复数据，组织成规范的文档发到群里。
场景 3：团队级别的智能助手 — 整个团队共用同一个 OpenClaw Agent，客服、销售、技术团队各取所需。
前置条件
- OpenClaw 已部署：系统正常运行（参考 Windows WSL2 踩坑指南）
- 飞书账号和权限：你是公司飞书工作区的管理员或拥有应用创建权限
- 飞书开放平台账号：访问 open.feishu.cn 注册/登录
第一步：创建飞书机器人应用
打开 飞书开放平台，点击”创建应用” → 选择”自建应用”→ 类型选”Bot” → 填写应用名称（如”OpenClaw AI Agent”）。创建后记录 App ID 和 App Secret，后续会用到。
第二步：在 OpenClaw 中安装飞书 Skill
打开 OpenClaw Web 界面 → 点击”Skill 市场” → 搜索”飞书”或”Feishu” → 安装”OpenClaw Feishu Skill” → 在配置页面填入 App ID、App Secret、Verification Token。
配置 OpenClaw 的 Webhook 接收地址（格式：http://your-openclaw-domain:8000/skills/feishu/webhook）。如果 OpenClaw 是本地运行，需要用 ngrok 内网穿透暴露出来。
第三步：配置飞书事件订阅
在飞书开放平台进入应用 → “事件订阅” → 填入 OpenClaw 的 Webhook 地址 → 勾选 message.receive 事件 → 提交验证。
第四步：配置飞书机器人权限
在”权限管理”中申请以下权限：im:message:write、im:message:read、im:chat:get、im:message:create_by_bot。
第五步：测试集成
确保 OpenClaw 正常运行后，将 Bot 添加到飞书测试群，发送：
@OpenClaw AI Agent 你好，请介绍一下自己收到 Agent 回复即成功。
第六步：实战演示
@OpenClaw 帮我查最近 7 天的网站 UV→ 自动查询数据库，返回格式化数据@OpenClaw 根据上周的代码 commit 生成技术周报→ 自动连接 Git 仓库，生成 Markdown 周报@OpenClaw 创建一个新的项目 Sprint，周期两周→ 调用项目管理系统 API，创建 Sprint
第七步：进阶配置
定时推送 — 在飞书 Skill 中用 Cron 表达式设置定时任务，让机器人主动推送每日工作提醒。
关键词触发 — 设置关键词（如”帮我查”、”生成”）自动触发对应 Skill，不需要 @ 也能响应。
常见问题排查
- 机器人无响应：检查 OpenClaw 服务状态（
docker ps），验证 Webhook URL 是否可访问 - 响应超时：对耗时操作改为异步处理（先回复”正在处理…”，完成后再推送）
- 权限不足：确认 Bot 已加入群，检查应用权限配置是否完整
安全最佳实践
Token 用环境变量存储；记录审计日志；申请最小权限；配置合理的请求队列速率；始终验证飞书消息的真实性（通过 Webhook Token）。