Openclaw 连接飞书流程

飞书是靠什么连接openclaw的？连接后怎么使用？

本文详细介绍了飞书是怎么设置的，设置后怎么连接openclaw，连接后怎么合理高效的使用openclaw

1. OpenClaw的安装

openclaw是什么？如何安装？请参考openclaw相关介绍

Note

openclaw的权限问题还是建议谨慎控制，沙盒机制可以帮助到你，但是鱼和熊掌不可兼得

现在各个云服务商提供的vps都可以预装openclaw，所以安装openclaw就变得非常简单了，想体验的也可以购买一个小的体验一下

2. 飞书设置

国内一开始没有软件对接，后面openclaw的火爆推动了各大软件的对接，再加上飞书各类协同工具和良好的开放能力，能够让你的 Agent 完成很多工作，所以飞书也在不断的改进

具体能力：

  1. 做你真正的数字分身：以你的身份完成工作（回消息、写文档、生成多维表格、创建文档等）；
  2. 更懂你的工作：帮你获取飞书内的海量上下文（含消息、文档、会议纪要、多维表格、日程、任务等）–这个看你飞书依赖程度了
  3. 与openclaw交流

2.1 飞书机器人搭建(企业应用)

飞书（飞书）搭建机器人流程很多，其实是 平台安全架构 + 企业软件生态设计导致的。简单说：它不是普通聊天机器人，而是企业级应用（App）。所以流程会比 Slack、Telegram 复杂很多。

Telegramd的机器人创建可以参考openclaw安装这篇文章

企业应用(App)的创建一般都是在后台开发平台进行创建

feishuhoutai

创建App的常规流程

  • 创建应用
  • 配置权限
  • 配置事件订阅
  • 配置机器人能力
  • 发布版本
  • 安装到企业
  1. 创建企业应用

找到企业自建应用然后点击创建企业自建应用，按照自己的需求写好应用的名称和描述，点击创建

feishuhoutai02

创建好之后界面相当于整个应用的处理，点击凭证与基础信息提供

  • 应用凭证(App ID)
  • App密钥(App Secret)
  1. 添加应用能力

在添加应用能力中选择机器人,然后点击添加

feishuhoutairobot

点击添加

  1. 配置权限

在侧边开发配置选择权限管理,点击批量导入/导出权限

feishuhoutai04

把下面的内容复制到JSON框内

{
  "scopes": {
    "tenant": [
      "contact:contact.base:readonly",
      "docx:document:readonly",
      "im:chat:read",
      "im:chat:update",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message.pins:read",
      "im:message.pins:write_only",
      "im:message.reactions:read",
      "im:message.reactions:write_only",
      "im:message:readonly",
      "im:message:recall",
      "im:message:send_as_bot",
      "im:message:send_multi_users",
      "im:message:send_sys_msg",
      "im:message:update",
      "im:resource",
      "application:application:self_manage",
      "cardkit:card:write",
      "cardkit:card:read"
    ],
    "user": [
      "contact:user.employee_id:readonly",
      "offline_access","base:app:copy",
      "base:field:create",
      "base:field:delete",
      "base:field:read",
      "base:field:update",
      "base:record:create",
      "base:record:delete",
      "base:record:retrieve",
      "base:record:update",
      "base:table:create",
      "base:table:delete",
      "base:table:read",
      "base:table:update",
      "base:view:read",
      "base:view:write_only",
      "base:app:create",
      "base:app:update",
      "base:app:read",
      "board:whiteboard:node:create",
      "board:whiteboard:node:read",
      "calendar:calendar:read",
      "calendar:calendar.event:create",
      "calendar:calendar.event:delete",
      "calendar:calendar.event:read",
      "calendar:calendar.event:reply",
      "calendar:calendar.event:update",
      "calendar:calendar.free_busy:read",
      "contact:contact.base:readonly",
      "contact:user.base:readonly",
      "contact:user:search",
      "docs:document.comment:create",
      "docs:document.comment:read",
      "docs:document.comment:update",
      "docs:document.media:download",
      "docs:document:copy",
      "docx:document:create",
      "docx:document:readonly",
      "docx:document:write_only",
      "drive:drive.metadata:readonly",
      "drive:file:download",
      "drive:file:upload",
      "im:chat.members:read",
      "im:chat:read",
      "im:message",
      "im:message.group_msg:get_as_user",
      "im:message.p2p_msg:get_as_user",
      "im:message.send_as_user",
      "im:message:readonly",
      "search:docs:read",
      "search:message",
      "space:document:delete",
      "space:document:move",
      "space:document:retrieve",
      "task:comment:read",
      "task:comment:write",
      "task:task:read",
      "task:task:write",
      "task:task:writeonly",
      "task:tasklist:read",
      "task:tasklist:write",
      "wiki:node:copy",
      "wiki:node:create",
      "wiki:node:move",
      "wiki:node:read",
      "wiki:node:retrieve",
      "wiki:space:read",
      "wiki:space:retrieve",
      "wiki:space:write_only"
    ]
  }
}

feishuhoutai05

点击下一步，然后申请开通即可

  1. 发布版本

只有发布了才能真正开始应用，否则一直处于开发状态，无法连接openclaw,版本号强制使用x.x.x

feishuhoutai06

2.2 安装飞书插件

现在飞书已经开发了插件 方便直接安装使用。之前的飞书连接可以参考官方文档

Note

如果历史上已安装了其他飞书插件，在这一步安装过程中将会自动禁用其他飞书插,但如果您安装飞书官方插件后再升级 OpenClaw 版本，需要手动禁用其他飞书插

下面适用于macOS和Linux系统，Windows请参考官方文档

# 1.设置注册表
npm config set registry https://registry.npmjs.org

# 2. 获取插件
curl -o /tmp/feishu-openclaw-plugin-onboard-cli.tgz https://sf3-cn.feishucdn.com/obj/open-platform-opendoc/4d184b1ba733bae2423a89e196a2ef8f_QATOjKH1WN.tgz 

# 3. 安装插件
npm install /tmp/feishu-openclaw-plugin-onboard-cli.tgz -g 

# 4. 删除安装包
rm /tmp/feishu-openclaw-plugin-onboard-cli.tgz

# 5. 加载
feishu-plugin-onboard install

feishu-plugin-onboard install启动的时候，会自动安装缺少的各种依赖，直到提醒你输入App ID

Installed plugin: feishu-openclaw-plugin
Restart the gateway to load plugins.
Configuring channels...
? Enter Feishu App ID:
  • 在凭证与基础信息中找到App ID，复制粘贴到上面
  • 然后按回车，会自动安装依赖，安装完成后，会提示你输入App Secret

3. openclaw连接飞书

使用npm install -g openclaw@latest安装好之后，常规的启动openclaw是下面的命令，但是这里不用

Note
  • openclaw onboard:启动 OpenClaw 的 onboard 服务（当前会话运行）
  • openclaw onboard --install-daemon 把 onboard 安装成系统后台服务（daemon）

这里在你插件安装命令完成后，会提醒你

Verifying installation...
Installation complete! You can now run "openclaw gateway run".
erwinbot@Home:~$ openclaw gateway run

你继续输入openclaw gateway run 即可完成设置

4. 事件与回调设置

订阅事件或回调后，飞书开放平台将会在事件（如机器人入群）发生时向请求地址推送消息。 注意：事件与回调的处理方式不同。订阅回调后，你需要立即返回响应内容，以反馈用户操作，而事件则不要求返回。

点击事件与配置–> 事件配置选择订阅方式，使用长连接接收事件

feishuhoutai07

然后点击添加事件–> 搜索接收消息–> 选择添加即可–> 同样也是发布版本，更新App信息即可

feishuhoutai08

5. openclaw连接飞书机器人

当你部署好机器人的企业应用app时，你可以在终端桌面或者手机端添加

你把它当作一个App里面的程序或者应用去添加，添加好之后随便发个消息

  1. 在飞书中向机器人发送任意消息，系统会生成一个配对码（字母+数字组合）；如果历史已安装过飞书插件，可能没有该配对过程。
  2. 配对码有效期为 5 分钟，超时需重新触发
  3. 在服务器终端执行以下命令完成绑定
openclaw pairing approve feishu xxxxx --notify
  1. 完成授权，便于后续 openclaw 可以通过你的身份完成消息、文档、多维表格、日历等任务
  2. 确认是否安装成功，可在应用对话框中输入：/feishu start；如果返回了版本号信息，则代表安装成功