大家好，我是程序員魚(yú)皮。

最近 OpenClaw 爆火，之前魚(yú)皮已經(jīng)出了 ，幫大家搞到了自己的小龍蝦 ，還接入了 QQ，隨時(shí)隨地在手機(jī)上跟 AI 對(duì)話：

不過(guò) QQ 畢竟偏個(gè)人社交，很多同學(xué)日常辦公用的是飛書，紛紛來(lái)問(wèn)我：魚(yú)皮，飛書能不能也接上？

必須安排！

OpenClaw 本身就支持各種第三方渠道，QQ、飛書、企微、Discord 都能接。

這篇文章，我來(lái)手把手教大家把 OpenClaw 接入飛書，以后掏出手機(jī)就能跟你的小龍蝦對(duì)話、讓它幫你干活，發(fā)圖片、發(fā)音視頻、發(fā)文件，通通不在話下。

點(diǎn)個(gè)收藏，我們開(kāi)始~

前期準(zhǔn)備

在開(kāi)始之前，你需要先有一只小龍蝦（已經(jīng)安裝好的 OpenClaw），沒(méi)有的同學(xué)請(qǐng)先看 安裝好再來(lái)。

OpenClaw 官方其實(shí)提供了 飛書接入文檔，流程并不復(fù)雜。

但由于是國(guó)外團(tuán)隊(duì)開(kāi)發(fā)的，官方提供的中文翻譯可能缺斤少兩，建議你先用 AI 幫你把文檔翻譯成中文，更容易理解。

比如我直接用 AI 編程工具 Cursor，讓它把官方文檔翻譯成了一個(gè)中文文檔網(wǎng)站：

請(qǐng)你幫我把 https://docs.openclaw.ai/channels/feishu 文檔翻譯為中文，保留文檔的原始結(jié)構(gòu)和圖片，確保能正常訪問(wèn)

翻譯后的文檔更加通俗易懂：

最后，去 官網(wǎng) 下載安裝「飛書客戶端」就好：

下面開(kāi)始正式操作，整個(gè)過(guò)程分為 5 步，無(wú)腦跟著做就行：

1. 飛書創(chuàng)建機(jī)器人應(yīng)用

2. OpenClaw 添加飛書頻道

3. 配置飛書事件

4. 私聊配對(duì)

5. 解鎖多媒體能力

首先，登錄 飛書開(kāi)放平臺(tái)，進(jìn)入開(kāi)發(fā)者后臺(tái)，點(diǎn)擊「創(chuàng)建企業(yè)自建應(yīng)用」：

填寫應(yīng)用名稱和描述，給你的機(jī)器人起個(gè)好聽(tīng)的名字吧，我這里叫「十三香」：

創(chuàng)建完成后進(jìn)入應(yīng)用詳情頁(yè)，在「添加應(yīng)用能力」中點(diǎn)擊添加機(jī)器人能力：

添加完機(jī)器人能力后，接下來(lái)要開(kāi)通權(quán)限。

進(jìn)入左側(cè)「權(quán)限管理」頁(yè)面：

選擇開(kāi)通哪些權(quán)限呢？

這里分兩種情況：

1）如果你的飛書里沒(méi)有敏感信息（比如個(gè)人玩耍用的），可以粗暴一點(diǎn)，直接把im:、contact:、file:、user、card、application相關(guān)的權(quán)限全勾上。注意，應(yīng)用身份權(quán)限和用戶身份權(quán)限要分別選擇。

飛書的權(quán)限控制還是很詳細(xì)的，每個(gè)權(quán)限的作用都標(biāo)得清清楚楚：

2）如果你經(jīng)常使用飛書，或者是企業(yè)飛書，有隱私數(shù)據(jù)，那就需要精細(xì)控制權(quán)限了。

最少只需要開(kāi)通以下 3 個(gè)：

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

如果你想更精細(xì)地選擇權(quán)限，但又不想一個(gè)個(gè)手動(dòng)勾選，可以直接復(fù)制下面這份 JSON 權(quán)限配置，通過(guò)批量導(dǎo)入一鍵搞定：

{
  "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"
    ]
  }
}

在權(quán)限管理頁(yè)面選擇批量導(dǎo)入：

把 JSON 粘貼進(jìn)去，點(diǎn)擊「確認(rèn)新增權(quán)限」就搞定了：

權(quán)限配置完成后，點(diǎn)擊「創(chuàng)建版本」，發(fā)布應(yīng)用：

填寫版本號(hào)和更新說(shuō)明、按需選擇是否對(duì)外共享：

然后申請(qǐng)線上發(fā)布：

發(fā)布后需要審核。由于我這個(gè)賬號(hào)本身就是管理員，自己審自己就行，秒通過(guò)：

進(jìn)入「飛書管理后臺(tái)」審核通過(guò)即可：

審核通過(guò)后，應(yīng)用會(huì)自動(dòng)上線：

可以看到發(fā)布成功的狀態(tài)：

最后，回到應(yīng)用的「憑證與基礎(chǔ)信息」頁(yè)面，獲取App ID和App Secret，復(fù)制保存好，下一步要用。

注意這倆是你機(jī)器人的鑰匙，千萬(wàn)不要泄露給別人！

二、OpenClaw 添加飛書頻道

拿到 App ID 和 App Secret 之后，就可以把飛書頻道綁定到 OpenClaw 了。

這里有兩種方法，任選其一。

方法一、讓 AI 自己來(lái)裝

直接在 OpenClaw 網(wǎng)頁(yè)端跟 AI 對(duì)話，把密鑰發(fā)過(guò)去，讓它幫你配：

幫我安裝飛書頻道，App ID 是 xxx，App Secret 是 xxx

讓 AI 自己給自己裝頻道，確實(shí)很符合 AI 時(shí)代的做事方式。但這個(gè)方法偶爾會(huì)翻車，AI 可能理解錯(cuò)你的意思。

方法二、命令行安裝（推薦）

打開(kāi)終端（Windows 用戶以管理員身份運(yùn)行 PowerShell，Mac 用戶打開(kāi)終端），執(zhí)行一行命令：

openclaw channels add

然后跟著向?qū)б徊讲讲僮骶秃?，幾?100% 成功。

先選擇要安裝的頻道，這里選擇Feishu頻道，然后選擇使用 npm 安裝工具下載：

接下來(lái)輸入你剛才保存的 App Secret 和 App ID，連接模式選擇WebSocket 長(zhǎng)連接。

還要選擇具體的頻道，國(guó)內(nèi)用戶選擇Feishu頻道，國(guó)外用戶選擇Lark。

然后配置 DM 私聊的訪問(wèn)控制方式，建議選擇配對(duì)碼模式，這樣只有通過(guò)配對(duì)碼驗(yàn)證的用戶才能跟機(jī)器人私聊，更安全。當(dāng)然這里跳過(guò)也行，后面隨時(shí)能改：

對(duì)接完成后，在 OpenClaw 網(wǎng)頁(yè)控制臺(tái)的頻道列表中就能看到飛書了：

三、配置飛書事件

頻道接好了，但還需要在飛書側(cè)配置事件訂閱，不然飛書不知道該把哪些消息推給 OpenClaw。

回到飛書開(kāi)發(fā)者后臺(tái)，進(jìn)入「事件與回調(diào)」配置，開(kāi)啟長(zhǎng)連接的事件訂閱方式：

然后添加事件，至少要添加接收消息（im.message.receive_v1） 這一項(xiàng)，其他的可以按需添加，比如機(jī)器人進(jìn)群、被移除群等：

添加好的事件列表如圖：

配置好事件后，別忘了最關(guān)鍵的一步：發(fā)布新版本！

改了配置不發(fā)布是不會(huì)生效的，很多人就卡在這一步：

這次更新版本會(huì)自動(dòng)審核通過(guò)：

到這里，飛書側(cè)的配置就全部搞定了，離成功就差最后一步了！

四、私聊配對(duì)

在飛書中搜索你剛才創(chuàng)建的機(jī)器人，進(jìn)入私聊。

隨便跟小龍蝦說(shuō)一句話，比如：我要驗(yàn)牌。

發(fā)送第一條消息后，機(jī)器人會(huì)返回一個(gè)配對(duì)碼：

拿到配對(duì)碼后，有兩種方式完成配對(duì)。

方式一、讓小龍蝦自己搞定

直接在 OpenClaw 網(wǎng)頁(yè)端把配對(duì)信息發(fā)給 AI，讓它幫你配：

幫我配對(duì)飛書渠道
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

在終端中執(zhí)行一行命令，把 <配對(duì)碼>替換成你自己收到的那串配對(duì)碼：

openclaw pairing approve feishu 
<配對(duì)碼>

執(zhí)行成功后，會(huì)提示配對(duì)完成：

配對(duì)成功后，再發(fā)一條消息試試，這次 AI 成功回復(fù)了！

到這里，你的 OpenClaw 就已經(jīng)和飛書打通了，可以愉快地聊起來(lái)了~

五、解鎖多媒體能力

基礎(chǔ)對(duì)話搞定了，但光是簡(jiǎn)單的聊天哪夠？

飛書支持豐富的消息類型，可以給小龍蝦發(fā)圖片、文件、音頻；也可以讓小龍蝦給我們發(fā)送圖片、音視頻、文件等，這才是 OpenClaw 接入飛書的魅力所在。

接下來(lái)我們依次嘗試讓小龍蝦給我們發(fā)送圖片、音頻、視頻和文件，探索一些簡(jiǎn)單實(shí)用的 OpenClaw 玩法。

發(fā)送圖片

比如你人在外面，想看看家里的情況，可以讓 AI 調(diào)用電腦攝像頭拍張照片發(fā)給你：

幫我通過(guò)電腦攝像頭拍一張照片，然后發(fā)送圖片給我

你可以在 OpenClaw 網(wǎng)頁(yè)控制臺(tái)看到它在干什么，比如調(diào)用了命令來(lái)操作攝像頭：

執(zhí)行過(guò)程中它可能會(huì)找你人工確認(rèn)操作。安全起見(jiàn)，建議大家一步一步來(lái)，防止 AI 誤操作或者浪費(fèi) Tokens。

不過(guò)由于我用的是備用機(jī)，為了追求效率（刺激），直接讓它自己干：

稍等一會(huì)兒，AI 說(shuō)已經(jīng)拍好了。

在電腦上的 OpenClaw 工作空間中，確實(shí)能看到它拍的照片，AI 輸出的圖片描述信息也是正確的：

但是，圖片并沒(méi)有成功發(fā)送到飛書啊？！

這其實(shí)也是很多同學(xué)反饋遇到的問(wèn)題。

別急，我們只需要給小龍蝦稍加引導(dǎo)，讓 AI 自己探索 “如何通過(guò)飛書發(fā)送多媒體消息”。

我通過(guò)飛書跟小龍蝦說(shuō)：

飛書支持給用戶發(fā)送圖片、文件、音頻、視頻并直接瀏覽，請(qǐng)你詳細(xì)了解具體的發(fā)送方法，并且必須要把需要發(fā)送的文件放到 workspace 工作空間中。你必須記住這些方法，之后快速地給我發(fā)送想要的內(nèi)容。

AI 會(huì)去讀取飛書技能文檔（安裝飛書頻道時(shí)會(huì)自動(dòng)安裝對(duì)應(yīng)的技能），學(xué)習(xí)怎么發(fā)送多媒體消息：

這次不僅成功發(fā)送了圖片，而且 AI 還很有學(xué)習(xí)精神，自己去研究有沒(méi)有更優(yōu)的方案：

它甚至自己創(chuàng)建了一個(gè)feishu-media技能，之后發(fā)送多媒體就更絲滑了。

這就是 AI 的厲害之處，只要你下命令，它就能自己研究問(wèn)題、自己解決問(wèn)題，還能把解決方案沉淀成可復(fù)用的技能，下次直接用。

在 OpenClaw 網(wǎng)頁(yè)控制臺(tái)的這兩個(gè)位置可以查看已安裝的技能。

AI 代理的技能：

OpenClaw 全局技能管理：

解鎖多媒體能力后，可以盡情玩耍了！

魚(yú)皮的「看家蝦」已上線：

錄制音頻并發(fā)送

假如你人在外面，想快速用電腦錄一段辦公室的聲音，一句話就能搞定：

錄制 3 秒音頻，然后發(fā)給我

AI 直接調(diào)用麥克風(fēng)完成了錄制，并把音頻文件發(fā)送到了飛書：

錄制視頻并發(fā)送

同樣的思路，想錄一段視頻也是一句話的事：

用攝像頭錄制 3 秒視頻，然后發(fā)給我

AI 自動(dòng)調(diào)用攝像頭錄制視頻，轉(zhuǎn)碼后直接發(fā)送到飛書，在手機(jī)上就能播放：

幫我找文件并發(fā)送

假設(shè)你人在外面，突然需要查看電腦上的一個(gè)文件，直接在飛書上跟小龍蝦說(shuō)一聲就行：

找到我電腦上的 yupi-hot-monitor 項(xiàng)目的 README.md 文件，并發(fā)送給我

AI 會(huì)幫你在電腦上找到文件，直接發(fā)到飛書里，點(diǎn)開(kāi)就能看：

至此，你的小龍蝦已經(jīng)和飛書完美對(duì)接了！發(fā)揮想象力盡情玩耍吧~

如果你的龍蝦不聽(tīng)話，直接在飛書里讓它去修復(fù)對(duì)應(yīng)的問(wèn)題就好，語(yǔ)氣可以強(qiáng)硬一點(diǎn)，它不會(huì)介意的。

實(shí)用小技巧 - 斜杠命令

最后再分享 2 個(gè)飛書里使用 OpenClaw 的小技巧，親測(cè)好用！

你可以在飛書對(duì)話框里直接輸入斜杠命令來(lái)控制 OpenClaw 的行為，不需要打開(kāi)網(wǎng)頁(yè)控制臺(tái)，非常方便。

1、斜杠命令 /new：新開(kāi)一個(gè)對(duì)話

直接在對(duì)話框里輸入/new，可以清空上下文開(kāi)啟一段新對(duì)話，讓 AI 更專注當(dāng)前任務(wù)，還能節(jié)省 Tokens 費(fèi)用。

2、斜杠命令 /verbose：開(kāi)啟調(diào)試模式

輸入/verbose on后，AI 會(huì)輸出更多執(zhí)行細(xì)節(jié)，方便你了解它到底在干什么，排查問(wèn)題也更方便。

比如我讓 AI 打開(kāi)自己的網(wǎng)站并截圖，能夠看到它通過(guò)編寫 JS 腳本、打開(kāi)了瀏覽器并執(zhí)行截圖的過(guò)程。

最后

OK，以上就是 OpenClaw 接入飛書的完整教程，希望能幫你少踩幾個(gè)坑。

從創(chuàng)建飛書機(jī)器人到玩轉(zhuǎn)多媒體發(fā)送，只要跟著做應(yīng)該都能搞定。接入之后，隨時(shí)隨地掏出手機(jī)就能讓 AI 幫你拍照、錄音、找文件、干活，效率直接拉滿。

為了幫大家更好地玩轉(zhuǎn) OpenClaw，魚(yú)皮建了一個(gè)OpenClaw 中文網(wǎng)，除了官方文檔的完整中文翻譯外，還整理了 OpenClaw 命令大全、斜杠命令大全等實(shí)用內(nèi)容，歡迎大家使用。

我會(huì)持續(xù)關(guān)注 OpenClaw 的發(fā)展，帶大家一起探索更多提高效率的玩法。如果你有收獲的話，記得關(guān)注一波，謝謝大家！