OpenClaw 飞书 (Feishu) 频道插件:全方位集成指南
发布日期: 2026-02-05摘要
这是 OpenClaw 飞书 (Feishu) 频道插件 的官方仓库,提供了详细的安装、配置和功能说明,旨在将 OpenClaw 的能力完整带入飞书生态。
- 全功能集成: 该插件支持飞书的私聊、群聊、收发消息、媒体文件,并集成了飞书的四大核心工具:文档 (Doc)、知识库 (Wiki)、云空间 (Drive) 和 多维表格 (Bitable) 的读写操作。
- 安装与配置: 安装通过
openclaw plugins install @m1heng-clawd/feishu完成。配置是核心,需要在飞书开放平台创建应用,获取App ID/Secret,并开启 **必需权限** (im:message等) 和配置 **事件订阅** (im.message.receive_v1)。 - 权限模型: 飞书的资源访问权限严格,机器人访问云空间、知识库和多维表格,都需要用户或管理员手动将相应的文件夹/空间/表格 **分享** 给机器人。
- 增强功能: 支持
auto/raw/card三种渲染模式,其中card模式能实现带语法高亮、表格的完整 Markdown 渲染。同时支持 @ 转发功能和权限错误提示。
安装与配置要点
该插件推荐使用 **长连接(WebSocket)** 模式连接飞书,以保证事件接收的稳定性和实时性。
必需 API 权限
至少需要开启以下权限以确保基本的收发消息功能:
im:message,im:message.p2p_msg:readonly,im:message.group_at_msg:readonly(消息收发)im:message:send_as_bot(机器人身份发送)im:resource(媒体上传和下载)
工具权限(读写)
若需使用 OpenClaw 提供的 `feishu_doc`, `feishu_wiki`, `feishu_drive`, `feishu_bitable` 工具进行操作,需要申请额外的读写权限,例如:
- 文档创建/编辑:
docx:document和docx:document.block:convert - 云空间操作:
drive:drive
⚠️ 资源访问限制: 机器人必须被手动添加为 云空间文件夹、知识库空间 或 多维表格 的成员(通过分享)。仅有 API 权限不足以访问这些资源。