大家好,我是程序员鱼皮。

最近 OpenClaw 爆火,之前鱼皮已经出了 ,帮大家搞到了自己的小龙虾 ,还接入了 QQ,随时随地在手机上跟 AI 对话:

打开网易新闻 查看精彩图片

不过 QQ 毕竟偏个人社交,很多同学日常办公用的是飞书,纷纷来问我:鱼皮,飞书能不能也接上?

必须安排!

OpenClaw 本身就支持各种第三方渠道,QQ、飞书、企微、Discord 都能接。

这篇文章,我来手把手教大家把 OpenClaw 接入飞书,以后掏出手机就能跟你的小龙虾对话、让它帮你干活,发图片、发音视频、发文件,通通不在话下。

点个收藏,我们开始~

前期准备

在开始之前,你需要先有一只小龙虾(已经安装好的 OpenClaw),没有的同学请先看 安装好再来。

打开网易新闻 查看精彩图片

OpenClaw 官方其实提供了 飞书接入文档,流程并不复杂。

但由于是国外团队开发的,官方提供的中文翻译可能缺斤少两,建议你先用 AI 帮你把文档翻译成中文,更容易理解。

比如我直接用 AI 编程工具 Cursor,让它把官方文档翻译成了一个中文文档网站:

请你帮我把 https://docs.openclaw.ai/channels/feishu 文档翻译为中文,保留文档的原始结构和图片,确保能正常访问
打开网易新闻 查看精彩图片

翻译后的文档更加通俗易懂:

打开网易新闻 查看精彩图片

最后,去 官网 下载安装「飞书客户端」就好:

打开网易新闻 查看精彩图片

下面开始正式操作,整个过程分为 5 步,无脑跟着做就行:

  1. 飞书创建机器人应用

  2. OpenClaw 添加飞书频道

  3. 配置飞书事件

  4. 私聊配对

  5. 解锁多媒体能力

一、飞书创建机器人应用

首先,登录 飞书开放平台,进入开发者后台,点击「创建企业自建应用」:

打开网易新闻 查看精彩图片

填写应用名称和描述,给你的机器人起个好听的名字吧,我这里叫「十三香」:

打开网易新闻 查看精彩图片

创建完成后进入应用详情页,在「添加应用能力」中点击添加机器人能力:

打开网易新闻 查看精彩图片

添加完机器人能力后,接下来要开通权限。

进入左侧「权限管理」页面:

打开网易新闻 查看精彩图片

选择开通哪些权限呢?

这里分两种情况:

1)如果你的飞书里没有敏感信息(比如个人玩耍用的),可以粗暴一点,直接把im:contact:file:usercardapplication相关的权限全勾上。注意,应用身份权限和用户身份权限要分别选择。

打开网易新闻 查看精彩图片

飞书的权限控制还是很详细的,每个权限的作用都标得清清楚楚:

打开网易新闻 查看精彩图片

2)如果你经常使用飞书,或者是企业飞书,有隐私数据,那就需要精细控制权限了。

最少只需要开通以下 3 个:

im:message
im:chat
contact:user.base:readonly

如果你想更精细地选择权限,但又不想一个个手动勾选,可以直接复制下面这份 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:read",
"cardkit:card:write",
"contact:user.employee_id:readonly",
"corehr:file:download",
"event:ip_list",
"im:chat.access_event.bot_p2p_chat:read",
"im:chat.members:bot_access",
"im:message",
"im:message.group_at_msg:readonly",
"im:message.p2p_msg:readonly",
"im:message:readonly",
"im:message:send_as_bot",
"im:resource"
],
"user": [
"aily:file:read",
"aily:file:write",
"im:chat.access_event.bot_p2p_chat:read"
]
}
}

在权限管理页面选择批量导入:

打开网易新闻 查看精彩图片

把 JSON 粘贴进去,点击「确认新增权限」就搞定了:

打开网易新闻 查看精彩图片

权限配置完成后,点击「创建版本」,发布应用:

打开网易新闻 查看精彩图片

填写版本号和更新说明、按需选择是否对外共享:

打开网易新闻 查看精彩图片

然后申请线上发布:

打开网易新闻 查看精彩图片

发布后需要审核。由于我这个账号本身就是管理员,自己审自己就行,秒通过:

打开网易新闻 查看精彩图片

进入「飞书管理后台」审核通过即可:

打开网易新闻 查看精彩图片
打开网易新闻 查看精彩图片

审核通过后,应用会自动上线:

打开网易新闻 查看精彩图片

可以看到发布成功的状态:

打开网易新闻 查看精彩图片

最后,回到应用的「凭证与基础信息」页面,获取App IDApp Secret,复制保存好,下一步要用。

打开网易新闻 查看精彩图片

注意这俩是你机器人的钥匙,千万不要泄露给别人!

二、OpenClaw 添加飞书频道

拿到 App ID 和 App Secret 之后,就可以把飞书频道绑定到 OpenClaw 了。

这里有两种方法,任选其一。

方法一、让 AI 自己来装

直接在 OpenClaw 网页端跟 AI 对话,把密钥发过去,让它帮你配:

帮我安装飞书频道,App ID 是 xxx,App Secret 是 xxx
打开网易新闻 查看精彩图片

让 AI 自己给自己装频道,确实很符合 AI 时代的做事方式。但这个方法偶尔会翻车,AI 可能理解错你的意思。

方法二、命令行安装(推荐)

打开终端(Windows 用户以管理员身份运行 PowerShell,Mac 用户打开终端),执行一行命令:

openclaw channels add
打开网易新闻 查看精彩图片

然后跟着向导一步步操作就好,几乎 100% 成功。

先选择要安装的频道,这里选择Feishu频道,然后选择使用 npm 安装工具下载:

打开网易新闻 查看精彩图片

接下来输入你刚才保存的 App Secret 和 App ID,连接模式选择WebSocket 长连接

还要选择具体的频道,国内用户选择Feishu频道,国外用户选择Lark

打开网易新闻 查看精彩图片

然后配置 DM 私聊的访问控制方式,建议选择配对码模式,这样只有通过配对码验证的用户才能跟机器人私聊,更安全。当然这里跳过也行,后面随时能改:

打开网易新闻 查看精彩图片

对接完成后,在 OpenClaw 网页控制台的频道列表中就能看到飞书了:

三、配置飞书事件
打开网易新闻 查看精彩图片
三、配置飞书事件

频道接好了,但还需要在飞书侧配置事件订阅,不然飞书不知道该把哪些消息推给 OpenClaw。

回到飞书开发者后台,进入「事件与回调」配置,开启长连接的事件订阅方式:

打开网易新闻 查看精彩图片

然后添加事件,至少要添加接收消息im.message.receive_v1) 这一项,其他的可以按需添加,比如机器人进群、被移除群等:

打开网易新闻 查看精彩图片

添加好的事件列表如图:

打开网易新闻 查看精彩图片

配置好事件后,别忘了最关键的一步:发布新版本!

改了配置不发布是不会生效的,很多人就卡在这一步:

打开网易新闻 查看精彩图片

这次更新版本会自动审核通过:

打开网易新闻 查看精彩图片

到这里,飞书侧的配置就全部搞定了,离成功就差最后一步了!

四、私聊配对

在飞书中搜索你刚才创建的机器人,进入私聊。

随便跟小龙虾说一句话,比如:我要验牌。

发送第一条消息后,机器人会返回一个配对码

打开网易新闻 查看精彩图片

拿到配对码后,有两种方式完成配对。

方式一、让小龙虾自己搞定

直接在 OpenClaw 网页端把配对信息发给 AI,让它帮你配:

帮我配对飞书渠道
OpenClaw: access not configured.
Your Feishu user id: ou_bed8be73675be0ee39023fee005dcf23
Pairing code: YUPIISDOG
Ask the bot owner to approve with:
openclaw pairing approve feishu YUPIISDOG
打开网易新闻 查看精彩图片
方式二、命令行配对(推荐)

在终端中执行一行命令,把 <配对码>替换成你自己收到的那串配对码:

openclaw pairing approve feishu 
<配对码>

执行成功后,会提示配对完成:

打开网易新闻 查看精彩图片

配对成功后,再发一条消息试试,这次 AI 成功回复了!

打开网易新闻 查看精彩图片

到这里,你的 OpenClaw 就已经和飞书打通了,可以愉快地聊起来了~

五、解锁多媒体能力

基础对话搞定了,但光是简单的聊天哪够?

飞书支持丰富的消息类型,可以给小龙虾发图片、文件、音频;也可以让小龙虾给我们发送图片、音视频、文件等,这才是 OpenClaw 接入飞书的魅力所在。

打开网易新闻 查看精彩图片

接下来我们依次尝试让小龙虾给我们发送图片、音频、视频和文件,探索一些简单实用的 OpenClaw 玩法。

发送图片

比如你人在外面,想看看家里的情况,可以让 AI 调用电脑摄像头拍张照片发给你:

帮我通过电脑摄像头拍一张照片,然后发送图片给我
打开网易新闻 查看精彩图片

你可以在 OpenClaw 网页控制台看到它在干什么,比如调用了命令来操作摄像头:

打开网易新闻 查看精彩图片

执行过程中它可能会找你人工确认操作。安全起见,建议大家一步一步来,防止 AI 误操作或者浪费 Tokens。

不过由于我用的是备用机,为了追求效率(刺激),直接让它自己干:

打开网易新闻 查看精彩图片

稍等一会儿,AI 说已经拍好了。

打开网易新闻 查看精彩图片

在电脑上的 OpenClaw 工作空间中,确实能看到它拍的照片,AI 输出的图片描述信息也是正确的:

打开网易新闻 查看精彩图片

但是,图片并没有成功发送到飞书啊?!

这其实也是很多同学反馈遇到的问题。

别急,我们只需要给小龙虾稍加引导,让 AI 自己探索 “如何通过飞书发送多媒体消息”。

我通过飞书跟小龙虾说:

飞书支持给用户发送图片、文件、音频、视频并直接浏览,请你详细了解具体的发送方法,并且必须要把需要发送的文件放到 workspace 工作空间中。你必须记住这些方法,之后快速地给我发送想要的内容。

AI 会去读取飞书技能文档(安装飞书频道时会自动安装对应的技能),学习怎么发送多媒体消息:

打开网易新闻 查看精彩图片

这次不仅成功发送了图片,而且 AI 还很有学习精神,自己去研究有没有更优的方案:

打开网易新闻 查看精彩图片

它甚至自己创建了一个feishu-media技能,之后发送多媒体就更丝滑了。

这就是 AI 的厉害之处,只要你下命令,它就能自己研究问题、自己解决问题,还能把解决方案沉淀成可复用的技能,下次直接用。

打开网易新闻 查看精彩图片

在 OpenClaw 网页控制台的这两个位置可以查看已安装的技能。

AI 代理的技能:

打开网易新闻 查看精彩图片

OpenClaw 全局技能管理:

打开网易新闻 查看精彩图片

解锁多媒体能力后,可以尽情玩耍了!

鱼皮的「看家虾」已上线:

录制音频并发送
打开网易新闻 查看精彩图片
录制音频并发送

假如你人在外面,想快速用电脑录一段办公室的声音,一句话就能搞定:

录制 3 秒音频,然后发给我

AI 直接调用麦克风完成了录制,并把音频文件发送到了飞书:

录制视频并发送
打开网易新闻 查看精彩图片
录制视频并发送

同样的思路,想录一段视频也是一句话的事:

用摄像头录制 3 秒视频,然后发给我

AI 自动调用摄像头录制视频,转码后直接发送到飞书,在手机上就能播放:

帮我找文件并发送
打开网易新闻 查看精彩图片
帮我找文件并发送

假设你人在外面,突然需要查看电脑上的一个文件,直接在飞书上跟小龙虾说一声就行:

找到我电脑上的 yupi-hot-monitor 项目的 README.md 文件,并发送给我

AI 会帮你在电脑上找到文件,直接发到飞书里,点开就能看:

打开网易新闻 查看精彩图片

至此,你的小龙虾已经和飞书完美对接了!发挥想象力尽情玩耍吧~

如果你的龙虾不听话,直接在飞书里让它去修复对应的问题就好,语气可以强硬一点,它不会介意的。

实用小技巧 - 斜杠命令

最后再分享 2 个飞书里使用 OpenClaw 的小技巧,亲测好用!

你可以在飞书对话框里直接输入斜杠命令来控制 OpenClaw 的行为,不需要打开网页控制台,非常方便。

1、斜杠命令 /new:新开一个对话

直接在对话框里输入/new,可以清空上下文开启一段新对话,让 AI 更专注当前任务,还能节省 Tokens 费用。

2、斜杠命令 /verbose:开启调试模式
打开网易新闻 查看精彩图片
2、斜杠命令 /verbose:开启调试模式

输入/verbose on后,AI 会输出更多执行细节,方便你了解它到底在干什么,排查问题也更方便。

比如我让 AI 打开自己的网站并截图,能够看到它通过编写 JS 脚本、打开了浏览器并执行截图的过程。

最后
打开网易新闻 查看精彩图片
最后

OK,以上就是 OpenClaw 接入飞书的完整教程,希望能帮你少踩几个坑。

从创建飞书机器人到玩转多媒体发送,只要跟着做应该都能搞定。接入之后,随时随地掏出手机就能让 AI 帮你拍照、录音、找文件、干活,效率直接拉满。

为了帮大家更好地玩转 OpenClaw,鱼皮建了一个OpenClaw 中文网,除了官方文档的完整中文翻译外,还整理了 OpenClaw 命令大全、斜杠命令大全等实用内容,欢迎大家使用。

打开网易新闻 查看精彩图片

我会持续关注 OpenClaw 的发展,带大家一起探索更多提高效率的玩法。如果你有收获的话,记得关注一波,谢谢大家!