# feishu-openclaw
飞书 × OpenClaw 保姆级配置指南 & 社区支持 让每个人都能用飞书轻松接入 OpenClaw(原 Clawdbot)。
📚 awesome-openclaw-usecases-zh — 装好了 OpenClaw,然后呢?
> > Skills 装了一堆,教程收藏了一堆,工具越来越多——但最缺的不是能力,而是经过国内适配和验证的场景。 > > 39 个真实用例,含飞书、钉钉、企业微信、小红书等国内生态适配方案,每个都有完整步骤和可复制的提示词。 > > 查看中文**用例合集 →
📢 飞书官方插件上线(2026.3.6)
飞书团队正式推出了 OpenClaw 飞书官方插件。目前飞书接入 OpenClaw 共有三种插件方式:
- (a) 飞书官方插件 — 飞书团队开发维护,支持以用户身份操作文档、日历、任务等
- (b) OpenClaw 内置飞书插件 — OpenClaw 社区维护(
@openclaw/feishu),OpenClaw ≥ 2026.2 已内置 - © 本项目插件 — 本仓库早期开发的社区飞书插件
👉 想了解飞书官方和 OpenClaw 内置插件的区别? 看 两个插件怎么选
👉 本项目插件的老用户? 看 如何迁移到飞书官方或 OpenClaw 内置插件
致社区
感谢大家一直以来的支持与信任 🙏
本项目最初是为了让飞书用户能更方便地接入 AI 助手——从独立桥接、到 npm 插件,再到一路踩坑填坑,这些都是大家的反馈推着走过来的。
现在,不仅 OpenClaw 内置了飞书插件(@openclaw/feishu),飞书团队也推出了官方的 OpenClaw 插件(feishu-openclaw-plugin)。这是件好事——说明飞书 + AI 这条路走通了,社区的需求被看到了。
本项目会继续为大家服务:
- 🎯 为非技术背景的伙伴提供最友好的入门引导
- 📊 帮你理清不同方案的区别,选对适合自己的路径
- 🔧 常见问题答疑 & 排查清单——官方文档没覆盖到的坑,这里帮你踩
- 🔄 为老用户提供迁移指南
遇到问题随时开 Issue,我们一起解决。
📋 目录
- 飞书官方插件(安装指南)
- 飞书官方 vs OpenClaw 内置:怎么选?
- OpenClaw 内置插件教程(从零配置)
- 从旧版迁移
- 常见问题 & 排查清单(含 API 配额耗尽 排查)
- 进阶配置参考
- Lark(国际版)接入指南
- 更新日志
- 链接
> 🚀 OpenCrew — 把你的 OpenClaw 变成一支 AI 团队 > > 多个 Agent 各管各的领域,Slack 频道=岗位,经验自动沉淀。 > > 3 个 Agent 起步 · 10 分钟部署 · 不用写代码 > > 查看 GitHub →
🆕 飞书官方插件
飞书团队推出的 OpenClaw 官方插件,最大的不同是:以你的身份操作飞书(通过 OAuth 授权)。
这意味着 AI 不只是"聊天机器人",而是能直接帮你写文档、建多维表格、约日程、管理任务——就像一个能操作飞书的数字分身。
> 📖 飞书团队的完整图文教程:OpenClaw 飞书官方插件上线 | 一文讲清功能、安装更新教程与常见问题
📊 飞书官方 vs OpenClaw 内置:怎么选?
两个插件不能同时使用(安装官方插件时会自动禁用内置插件)。
| 维度 | 飞书官方插件 | OpenClaw 内置插件 |
|---|---|---|
| 操作身份 | 以你本人身份(OAuth) | 以机器人身份 |
| 消息 | 读取、发送、回复、搜索 | 读取、发送、回复 |
| 文档 | 创建 + 编辑 + 读取 | 读取为主 |
| 多维表格 | 完整操作(表、字段、记录、视图) | 基础读写 |
| 日历日程 | ✅ 创建/查询/修改/搜索/忙闲查询 | ❌ |
| 任务管理 | ✅ 创建/查询/更新/完成/子任务 | ❌ |
| 知识库 | ✅ 完整读写 | ✅ 只读 |
| 云盘 | ✅ 上传/下载 | ✅ 基础操作 |
| 流式输出 | ✅ | ✅ |
| 安装复杂度 | 需要额外安装 CLI 工具 + OAuth 授权 | OpenClaw 内置,openclaw channels add 即可 |
| 维护方 | 飞书团队 | OpenClaw 社区 |
| 问题反馈 | 飞书反馈群 | 本项目 Issues / Discord |
选择建议
选飞书官方插件,如果你:
- 想让 AI 帮你操作飞书(写文档、建表、约会议)
- 需要日历、任务管理等高级功能
- 想要以自己身份发消息(不是机器人名义)
选 OpenClaw 内置插件,如果你:
- 主要用飞书做聊天入口,让 AI 回答问题、执行本地任务
- 不需要 AI 操作飞书文档/日历/任务
- 偏好更简单的安装流程(内置即用)
🚀 OpenClaw 内置插件教程(从零配置)
> 适用于:第一次使用 OpenClaw + 飞书的新用户,选择 OpenClaw 内置插件方案。 > 前提:已安装 OpenClaw 并正常运行(openclaw gateway status 能看到状态)。 > 预计耗时:15–20 分钟。
第一步:创建飞书应用(机器人)
- 打开 飞书开放平台,用飞书账号登录
- 点击 创建企业自建应用
- 填写应用名称(随意,比如 "我的 AI 助手")和描述
- 选一个图标(可以之后改)
第二步:启用机器人能力
进入你刚创建的应用:
- 左侧菜单找到 应用能力 > 机器人
- 开启机器人能力
- 给机器人起个名字
第三步:配置权限
- 左侧菜单进入 权限管理
- 点击 批量导入
- 粘贴以下 JSON(一键导入所有需要的权限):
{ "scopes": { "tenant": [ "aily:file:read", "aily:file:write", "application:application.app_message_stats.overview:readonly", "application:application:self_manage", "application:bot.menu:write", "cardkit:card:write", "contact:user.employee_id:readonly", "corehr:file:download", "docs:document.content:read", "event:ip_list", "im:chat", "im:chat.access_event.bot_p2p_chat:read", "im:chat.members:bot_access", "im:message", "im:message.group_at_msg:readonly", "im:message.group_msg", "im:message.p2p_msg:readonly", "im:message:readonly", "im:message:send_as_bot", "im:resource", "sheets:spreadsheet", "wiki:wiki:readonly" ], "user": [ "aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read" ] } }
第四步:配置事件订阅
> ⚠️ 这一步必须在 OpenClaw 网关启动后再做,否则保存会失败。 > 先做第五、六步,回来再做这一步也可以。
- 左侧菜单进入 事件与回调 > 事件配置
- 请求方式选择:使用长连接接收事件(这是关键!不需要公网服务器)
- 添加事件:搜索
im.message.receive_v1(接收消息),勾选添加
第五步:记下凭证
在应用的 凭证与基础信息 页面,复制:
- App ID(格式如
cli_xxxxxxxxx) - App Secret
> ❗ App Secret 很重要,请妥善保管,不要分享。
第六步:发布应用
- 左侧菜单 版本管理与发布
- 创建版本 → 填写版本说明 → 提交
- 等待审批(企业内�
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/231494.html