OpenClaw安装飞书插件

2026-05-06阅读 0热度 0

ai microsoft 飞书

OpenClaw飞书插件集成

将OpenClaw接入飞书，你会发现它带来的远非简单的消息收发，而是一整套深度集成的工作流。这意味着，一个真正的智能工作伙伴，已经来到了你的飞书里。它能做什么？我们来具体看看。

首先是群聊@响应功能。在繁忙的工作群里，当同事@OpenClaw并提问“本周会议纪要在哪里？”时，无需人工干预，系统会自动理解意图，并在知识库中精准检索，直接回复相关文档的链接。这个功能相当灵活，可以根据团队的实际工作节奏，配置即时回复或延迟处理等多种响应模式，确保信息推送恰到好处。

其次是单聊交互功能。这相当于为每位员工配备了一位7×24小时在线的一对一专属助理。无论是查询个人考勤、申请审批流程，还是咨询公司政策，员工都可以通过私聊快速获得答案。交互形式也相当丰富，支持图文、表格、文件等多种富文本消息，沟通效率和体验大大提升。

再来看文档协作功能。在多人协同编辑飞书文档时，OpenClaw能够实时同步编辑状态，并提供版本对比和智能修改建议。一个典型场景是，当多人同时修改同一段落导致内容冲突时，它可以主动介入，给出清晰、合理的合并建议，有效避免“版本地狱”。

除此之外，集成还解锁了一系列强大的扩展功能：

会议管理：自动同步飞书日历中的会议日程，并在会后智能生成结构化会议纪要。
任务追踪：能够根据群聊或私聊中的讨论内容，自动识别并创建待办任务，甚至智能分配给相关人员。
数据看板：整合来自多个业务系统的数据，一键生成可视化报表，让决策有据可依。

看到这里，你可能已经跃跃欲试了。别急，接下来的配置过程虽然步骤清晰，但需要你仔细操作。我们这就一步步来实现它。

一、飞书应用创建与配置

一切从飞书开放平台开始。首先，请访问 https://open.feishu.cn/app，并使用你的企业飞书管理员账号登录。

第一步：创建企业自建应用。 登录后，点击页面上的“创建企业自建应用”按钮。在弹出的窗口中，为你的应用起个名，比如“OpenClaw 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"]}}

顺利开通后，你的权限管理页面应该类似下图所示，拥有一系列已开通的权限条目。

第四步：获取应用凭证。 点击左侧的“凭证与基础信息”，在这里你可以找到属于这个应用的“App ID”和“App Secret”。请务必将这两串字符妥善复制并保存下来，它们是后续配置OpenClaw时必须用到的“钥匙”。

第五步：发布应用（测试版）。 完成基础配置后，我们需要先发布一个版本供测试。点击“版本管理与发布”，然后点击“创建版本”。填写一个初始版本号，例如“1.0.0”。在可用范围选择上，为了安全起见，建议先选择“部分成员”（即指定测试人员）。由于是自建应用，通常无需飞书官方审核即可直接生效。

二、OpenClaw飞书插件配置

飞书端的应用准备好了，现在轮到OpenClaw了。请在你的OpenClaw服务器上，通过命令行执行以下一组配置命令。特别注意，需要将命令中的占位符替换成你刚刚从飞书平台获取的真实信息。

# 1. 安装飞书插件（如果已预装可跳过或按后续说明处理）
openclaw plugins install @m1heng-clawd/feishu

# 2. 配置飞书App ID（将引号内容替换为你的飞书App ID）
openclaw config set channels.feishu.appId "你的飞书App ID"

# 3. 配置飞书App Secret（将引号内容替换为你的飞书App Secret）
openclaw config set channels.feishu.appSecret "你的飞书App Secret"

# 4. 启用飞书通道
openclaw config set channels.feishu.enabled true

# 5. 配置连接方式为WebSocket（推荐方式，连接更稳定）
openclaw config set channels.feishu.connectionMode websocket

# 6. 重启Gateway服务使所有配置生效
openclaw gateway restart

三、配置飞书插件事件回调

回到飞书开放平台，配置事件订阅。 在左侧导航栏单击“事件与回调”，进入到事件配置页签。

首先，在“订阅方式”处选择“使用长连接接收事件”，然后点击“保存”。这种方式通常比Webhook更稳定。

然后，在“事件配置”区域，点击“添加事件”。在搜索框中输入 im.message.receive_v1，这个事件代表“接收用户发给机器人的消息”。找到后，单击它并确认添加。这意味着，此后所有用户发给机器人的消息，飞书都会通过长连接推送到我们配置好的OpenClaw服务上。

再次发布应用。 事件订阅也是一种配置变更，需要发布新版本才会生效。点击“版本管理与发布”，再次“创建版本”，将版本号更新为“1.0.1”，选择同样的可用范围，点击发布。

注意一个小细节：在完成上一步（OpenClaw插件配置并重启）之前，飞书端事件订阅的“长连接”状态可能无法正常连接。所以，正确的顺序是先配置好OpenClaw端，再回到飞书平台完成本步骤的事件订阅与发布。

四、设备配对

激动人心的时刻到了——让两端“握手”相识。现在，拿起你的手机，打开飞书APP。

进入“工作台”页面，你应该能找到刚刚发布的“OpenClaw AI助手”应用，点击打开它。

在聊天窗口里，给机器人发送任意一条消息，比如简单的“你好”。
此时，机器人会给你回复一个数字或字母组成的配对码。同时，请回到你的OpenClaw服务器控制台。
在服务器控制台输入命令：openclaw pairing approve feishu 配对码（将“配对码”替换为收到的具体代码）。当然，你也可以登录OpenClaw的Web管理页面，在相应的界面中完成这个批准操作。

配对成功后，飞书应用和你的OpenClaw服务器就建立了可信连接，可以开始正式通信了。

五、功能验证

现在，是时候验收成果了。请按照以下步骤进行全面验证：

单聊测试： 再次打开飞书APP中的“OpenClaw AI助手”，发送“你好”或其他问题，如果很快收到了AI流畅、准确的回复，恭喜你，基础单聊通道已完全打通。
群聊测试： 邀请这个机器人进入任何一个飞书群聊。在群中，尝试@机器人并提出一个指令，例如“总结本次会议要点”或“我们的项目文档在哪？”。观察机器人是否能够准确识别@指令并作出响应。这一步验证了群聊交互和智能解析能力。

如果以上两步都通过了，那么一个功能完整的OpenClaw飞书助手就已经成功部署并准备为你服务了。

六、常见问题排查

配置过程偶尔会遇到一些小波折，别担心，这里有两个最常见问题的解决方案。

（一）飞书权限缺失

问题现象： 配置完成后，与AI交互时，服务器日志或飞书提示出现类似 contact:contact.base:readonly 的权限错误。

解决方案： 这说明我们在第一步权限配置时可能遗漏了某个权限。重新登录飞书开放平台，进入该应用的“权限管理”页面。在搜索框中搜索缺失的权限名称（如上面示例的 contact:contact.base:readonly），找到后将其勾选并“申请开通”，然后重新发布应用版本即可。

（二）飞书插件重复

问题现象： 新版本的OpenClaw在全局已经预装了飞书插件。如果你再次手动执行 openclaw plugins install @m1heng-clawd/feishu，系统会提示插件重复。虽然不影响实际功能，但每次执行命令都可能出现烦人的警告信息。

解决方案： 移除重复的插件文件即可。你需要找到飞书插件在OpenClaw系统中的安装位置，通常路径为 /home/你的用户名称/.openclaw/extensions。进入该目录，找到与“feishu”相关的文件夹，将其直接删除。这样，OpenClaw就会统一使用其全局预装的飞书组件，避免冲突。操作完成后，别忘了重启OpenClaw网关服务。