OpenClaw飞书插件集成

OpenClaw接入飞书后,可实现以下深度集成功能:

  1. 群聊@响应功能
  • 支持智能识别群聊中@OpenClaw的消息
  • 可配置多种响应模式(即时回复/延迟处理)
  • 示例:当用户在飞书群中@OpenClaw并提问"本周会议纪要在哪里?",系统会自动检索并回复相关文档链接
  1. 单聊交互功能
  • 提供7×24小时一对一对话服务
  • 支持富文本消息(图文/表格/文件)交互
  • 应用场景:员工可通过私聊查询考勤、申请审批等HR事务
  1. 文档协作功能
  • 实时同步飞书文档编辑状态
  • 支持版本对比和修改建议
  • 典型用例:多人协作时,OpenClaw可自动检测文档冲突并给出合并建议
  1. 扩展功能
  • 会议管理:自动同步会议日程,智能生成会议纪要
  • 任务追踪:根据聊天内容自动创建并分配任务
  • 数据看板:整合多源数据生成可视化报表

一、飞书应用创建与配置

  1. 访问飞书开放平台(https://open.feishu.cn/app),登录企业飞书账号;

  2. 创建企业自建应用:

    • 点击“创建企业自建应用”,输入应用名称(如“OpenClaw AI助手”),上传图标,点击“创建”;

      创建应用
      创建应用描述

  3. 添加机器人能力:

    • 左侧导航栏点击“添加应用能力”,选择“机器人”→“添加”;

    机器人能力添加

  4. 权限配置:

    • 左侧导航栏单击 权限管理 页面,点击批量导入/导出权限 按钮,粘贴以下 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"]
        }
      }
      

      开通之后的样子:

      权限开通后

  5. 获取应用凭证:

    • 点击“凭证与基础信息”,复制“App ID”和“App Secret”,保存备用;

      应用凭证

  6. 发布应用:

    • 点击“版本管理与发布”→“创建版本”,填写版本号(如1.0.0),选择“部分成员”测试,无需审核即可生效。

      版本发布

二、OpenClaw飞书插件配置

安装步骤:

# 1. 安装飞书插件
openclaw plugins install @m1heng-clawd/feishu

# 2. 配置飞书App ID(替换为飞书平台获取的ID)
openclaw config set channels.feishu.appId "你的飞书App ID"

# 3. 配置飞书App Secret(替换为飞书平台获取的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

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

  1. 配置事件订阅

    • 在飞书开放平台左侧导航栏单击事件与回调,在事件配置页签中单击订阅方式,选择使用 长连接 接收事件,单击保存

    • 在事件配置页面,单击添加事件,搜索事件im.message.receive_v1(接收消息),单击确认添加

      事件回调

  2. 发布应用

    • 点击“版本管理与发布”→“创建版本”,填写版本号(如1.0.1),选择“部分成员”测试,无需审核即可生效。

注意:在没有与OpenClaw配置连接之前是无法配置事件回调

四、设备配对

  1. 打开飞书APP,进入“工作台”,找到已发布的“OpenClaw AI助手”;
    飞书控制台

  2. 发送任意一条消息,比如“你好”,机器人会回复一个配对码,在服务器控制台输入openclaw pairing approve feishu 配对码完成配对,也可以放到OpenClaw的在WebUI页面中让其执行;
    设备配对

五、功能验证

  1. 打开飞书APP,进入“工作台”,找到已发布的“OpenClaw AI助手”;
  2. 发送“你好”,若收到AI正确回复,说明接入成功;
  3. 群聊使用:在飞书群中@机器人,发送指令(如“总结本次会议要点”),机器人将自动响应。

六、问题

(一)飞书权限缺失

配置完成后与AI交互可能会出现权限缺失问题contact:contact.base:readonly,重新登陆飞书控制台,在权限管理中重新开通对应缺失权限即可
权限缺失

(二)飞书插件重复

新版的OpenClaw全局预装了飞书插件,后续不管是升级OpenClaw版本还是自己下载飞书插件都会提示重复问题。虽然不影响实际使用,但是每次执行命令都会出现警告

解决方式:找到飞书插件在OpenClaw中位置,通常为/home/你的用户名称/.openclaw/extensions,将这个目录下的飞书文件夹直接删除,让OpenClaw继续使用全局配置的飞书组件,最后重启OpenClaw网关

Logo

有“AI”的1024 = 2048,欢迎大家加入2048 AI社区

更多推荐