技术文档

Appearance

创建并配置飞书机器人 ​

创建飞书应用 ​

  • 打开飞书开放平台：

https://open.feishu.cn/

点击开发者后台-> 创建企业自建应用

填写信息后点击 创建

配置机器人权限 ​

  • 点击添加，就可以到机器人管理页面
  • 点击权限管理，然后点击开通权限
  • 在搜索框输入im:message，然后确认开通权限
  • 如果觉得麻烦的话可以选择批量导入/导出权限，将以下配置复制粘贴到导入框
bash
{
  "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:contact.base:readonly",
      "contact:user.employee_id:readonly",
      "corehr:file:download",
      "docs:document.content:read",
      "docx:document",
      "docx:document.block:convert",
      "docx:document:readonly",
      "event:ip_list",
      "im:chat",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:bot_access",
      "im:chat:readonly",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.group_msg",
      "im:message.p2p_msg:readonly",
      "im:message.reactions:read",
      "im:message:readonly",
      "im:message:recall",
      "im:message:send_as_bot",
      "im:message:send_multi_depts",
      "im:message:send_multi_users",
      "im:message:send_sys_msg",
      "im:message:update",
      "im:resource",
      "sheets:spreadsheet",
      "wiki:wiki:readonly"
    ],
    "user": [
      "aily:file:read",
      "aily:file:write",
      "contact:user.base:readonly",
      "docx:document.block:convert",
      "im:chat.access_event.bot_p2p_chat:read"
    ]
  }
}
  • 然后点击创建版本
  • 填写相关信息后保存
  • 确认发布
  • 然后你会在飞书里面收到审核通过的消息，如果没有那就自己手动审核一下

安装飞书插件并接入 OpenClaw ​

飞书机器人创建完成后，需要安装飞书插件，才能让 OpenClaw 和飞书机器人联动。 最新版本的OpenClaw都内置了飞书插件，可以直接安装： 在终端输入命令：

bash
openclaw config
  • 选择Local（this machine）
  • 然后选择Channels
  • 选择Configure/link
  • 选择Feishu/Lark
  • 选择 Download from npm 或者 Use local plugin path
  • 完成后直接到【填入飞书机器人的 App ID 和 App Secret】这一节

下面步骤是编译安装的，选择自动安装的可以忽略

下载并安装飞书插件 ​

bash
openclaw plugins install ./feishu-0.1.6.tgz

安装成功后，会看到如下界面（重点记住红框内的插件路径，每个人的可能不一样）：

示例路径：C:\Users\agent\.openclaw\extensions\feishu（替换成你自己的路径）

配置飞书插件依赖 ​

    1. 新建终端：以管理员身份打开一个新的终端（和之前的 Git Bash 分开）
    1. 进入插件目录：输入以下命令（替换成你自己的插件路径），按回车键：

cd C:\Users\agent\.openclaw\extensions\feishu

    1. 安装依赖：执行 pnpm install，出现如下界面说明依赖安装成功

关联飞书机器人和 OpenClaw ​

回到之前的 Git Bash 终端，按照以下步骤操作：

  1. 打开 OpenClaw 配置：输入 openclaw config，选择 Local(this machine)，按回车键
  1. 选择 Channels，按回车键
    1. 选择 Configure/link，按回车键
    1. 选择飞书插件：可以看到飞书插件已安装，选择 Feishu/Lark（飞书），按回车键

填入飞书机器人的 App ID 和 App Secret ​

    1. 获取 App ID 和 App Secret：登录飞书开放平台，进入你创建的机器人的 基础信息 页面，找到这两个值
    1. 填入 App ID，按回车键
    1. 填入 App Secret，按回车键
    1. 配置完成：出现如下界面，说明飞书机器人和 OpenClaw 关联成功

后续配置及重启服务 ​

    1. 继续配置：按回车键，选择 Open-respond in all groups，再按回车键
    1. 选择 Finished，按回车键
    1. 选择 Yes，按回车键
    1. 选择 Open，按回车键
    1. 选择 Continue，按回车键
    1. 重启服务：执行 pnpm openclaw gateway，看到如下界面，说明飞书插件配置成功

飞书机器人事件与回调配置 ​

    1. 进入配置页面：登录飞书开放平台，进入你创建的机器人，选择 事件与回调
    1. 选择订阅方式：全部选择 使用长链接接收事件

添加必需事件 ​

    1. 点击 添加事件
    1. 添加以下 4 个事件：
事件说明
im.message.receive_v1接收消息（必需）
im.message.message_read_v1消息已读
im.chat.member.bot.added_v1机器人进群
im.chat.member.bot.deleted_v1机器人被移出群

通过搜索框查询完成添加：

重新发布应用 ​

    1. 点击上方的 创建版本，填入相关信息，然后点击 保存
    1. 点击 确认发布，完成事件配置

开始使用你的机器人 ​

打开飞书，找到你的机器人，直接对话测试。

网站备案号:津ICP备15001525号-2