大家好,我是程序员鱼皮。
最近 OpenClaw 爆火,之前鱼皮已经出了 ,帮大家搞到了自己的小龙虾 ,还接入了 QQ,随时随地在手机上跟 AI 对话:
不过 QQ 毕竟偏个人社交,很多同学日常办公用的是飞书,纷纷来问我:鱼皮,飞书能不能也接上?
必须安排!
OpenClaw 本身就支持各种第三方渠道,QQ、飞书、企微、Discord 都能接。
这篇文章,我来手把手教大家把 OpenClaw 接入飞书,以后掏出手机就能跟你的小龙虾对话、让它帮你干活,发图片、发音视频、发文件,通通不在话下。
点个收藏,我们开始~
前期准备
在开始之前,你需要先有一只小龙虾(已经安装好的 OpenClaw),没有的同学请先看 安装好再来。
OpenClaw 官方其实提供了 飞书接入文档,流程并不复杂。
但由于是国外团队开发的,官方提供的中文翻译可能缺斤少两,建议你先用 AI 帮你把文档翻译成中文,更容易理解。
比如我直接用 AI 编程工具 Cursor,让它把官方文档翻译成了一个中文文档网站:
请你帮我把 https://docs.openclaw.ai/channels/feishu 文档翻译为中文,保留文档的原始结构和图片,确保能正常访问
翻译后的文档更加通俗易懂:
最后,去 官网 下载安装「飞书客户端」就好:
下面开始正式操作,整个过程分为 5 步,无脑跟着做就行:
飞书创建机器人应用
OpenClaw 添加飞书频道
配置飞书事件
私聊配对
解锁多媒体能力
首先,登录 飞书开放平台,进入开发者后台,点击「创建企业自建应用」:
填写应用名称和描述,给你的机器人起个好听的名字吧,我这里叫「十三香」:
创建完成后进入应用详情页,在「添加应用能力」中点击添加机器人能力:
添加完机器人能力后,接下来要开通权限。
进入左侧「权限管理」页面:
选择开通哪些权限呢?
这里分两种情况:
1)如果你的飞书里没有敏感信息(比如个人玩耍用的),可以粗暴一点,直接把im:、contact:、file:、user、card、application相关的权限全勾上。注意,应用身份权限和用户身份权限要分别选择。
飞书的权限控制还是很详细的,每个权限的作用都标得清清楚楚:
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 ID和App 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 费用。
输入/verbose on后,AI 会输出更多执行细节,方便你了解它到底在干什么,排查问题也更方便。
比如我让 AI 打开自己的网站并截图,能够看到它通过编写 JS 脚本、打开了浏览器并执行截图的过程。
OK,以上就是 OpenClaw 接入飞书的完整教程,希望能帮你少踩几个坑。
从创建飞书机器人到玩转多媒体发送,只要跟着做应该都能搞定。接入之后,随时随地掏出手机就能让 AI 帮你拍照、录音、找文件、干活,效率直接拉满。
为了帮大家更好地玩转 OpenClaw,鱼皮建了一个OpenClaw 中文网,除了官方文档的完整中文翻译外,还整理了 OpenClaw 命令大全、斜杠命令大全等实用内容,欢迎大家使用。
我会持续关注 OpenClaw 的发展,带大家一起探索更多提高效率的玩法。如果你有收获的话,记得关注一波,谢谢大家!
热门跟贴