深度文章

OpenClaw 飞书 (Feishu) 频道插件:全方位集成指南

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:documentdocx:document.block:convert
  • 云空间操作:drive:drive

⚠️ 资源访问限制: 机器人必须被手动添加为 云空间文件夹知识库空间多维表格 的成员(通过分享)。仅有 API 权限不足以访问这些资源。

原文仓库链接: https://github.com/m1heng/clawdbot-feishu