OpenClaw接入飞书保姆级教程，几分钟搞定手机养龙虾！

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

最近 OpenClaw 爆火，之前鱼皮已经出了《保姆级小龙虾安装教程》，帮大家搞到了自己的小龙虾 🦞，还接入了 QQ，随时随地在手机上跟 AI 对话：

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

必须安排！

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

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

点个收藏，我们开始~

前期准备

在开始之前，你需要先有一只小龙虾（已经安装好的 OpenClaw），没有的同学请先看《鱼皮的保姆级装虾教程》安装好再来。

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

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

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

markdown 复制代码

请你帮我把 https://docs.openclaw.ai/channels/feishu 文档翻译为中文，保留文档的原始结构和图片，确保能正常访问

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

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

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

飞书创建机器人应用
OpenClaw 添加飞书频道
配置飞书事件
私聊配对
解锁多媒体能力

📺 本文对应视频教程：www.bilibili.com/video/BV1QP...

一、飞书创建机器人应用

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

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

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

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

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

选择开通哪些权限呢？

这里分两种情况：

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

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

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

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

markdown 复制代码

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

如果你想更精细地选择权限，但又不想一个个手动勾选，可以直接复制下面这份 JSON 权限配置，通过批量导入一键搞定：

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 对话，把密钥发过去，让它帮你配：

markdown 复制代码

帮我安装飞书频道，App ID 是 xxx，App Secret 是 xxx

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

方法二、命令行安装（推荐）

打开终端（Windows 用户以管理员身份运行 PowerShell，Mac 用户打开终端），执行一行命令：

bash 复制代码

openclaw channels add

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

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

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

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

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

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

三、配置飞书事件

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

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

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

添加好的事件列表如图：

配置好事件后，别忘了最关键的一步：发布新版本！

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

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

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

四、私聊配对

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

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

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

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

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

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

markdown 复制代码

帮我配对飞书渠道
OpenClaw: access not configured.
Your Feishu user id: ou_xxxxxxxxxxxxxxxx
Pairing code: YUPIISDOG
Ask the bot owner to approve with:
openclaw pairing approve feishu YUPIISDOG

方式二、命令行配对（推荐）

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

bash 复制代码

openclaw pairing approve feishu <配对码>

执行成功后，会提示配对完成：

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

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

五、解锁多媒体能力

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

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

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

发送图片

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

markdown 复制代码

帮我通过电脑摄像头拍一张照片，然后发送图片给我

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

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

不过由于我用的是备用机，为了追求效率（刺激），直接让它自己干：

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

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

但是，图片并没有成功发送到飞书啊？！

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

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

我通过飞书跟小龙虾说：

markdown 复制代码

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

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

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

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

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

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

AI 代理的技能：

OpenClaw 全局技能管理：

解锁多媒体能力后，可以尽情玩耍了！

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

录制音频并发送

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

markdown 复制代码

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

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

录制视频并发送

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

markdown 复制代码

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

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

帮我找文件并发送

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

markdown 复制代码

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

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

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

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

实用小技巧 - 斜杠命令

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

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

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

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

2、斜杠命令 /verbose：开启调试模式

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

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

最后

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

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

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

点击头像，然后私信「openclaw」，可免费获取。

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