大家好，我是程序員魚皮。

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

不過 QQ 畢竟偏個人社交，很多同學(xué)日常辦公用的是飛書，紛紛來問我：魚皮，飛書能不能也接上？

必須安排！

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

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

點個收藏，我們開始~

前期準備

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

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

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

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

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

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

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

下面開始正式操作，整個過程分為 5 步，無腦跟著做就行：

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

2. OpenClaw 添加飛書頻道

3. 配置飛書事件

4. 私聊配對

5. 解鎖多媒體能力

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

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

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

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

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

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

這里分兩種情況：

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

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

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

最少只需要開通以下 3 個：

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

如果你想更精細地選擇權(quán)限，但又不想一個個手動勾選，可以直接復(fù)制下面這份 JSON 權(quán)限配置，通過批量導(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)限管理頁面選擇批量導(dǎo)入：

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

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

填寫版本號和更新說明、按需選擇是否對外共享：

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

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

進入「飛書管理后臺」審核通過即可：

審核通過后，應(yīng)用會自動上線：

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

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

注意這倆是你機器人的鑰匙，千萬不要泄露給別人！

二、OpenClaw 添加飛書頻道

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

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

方法一、讓 AI 自己來裝

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

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

讓 AI 自己給自己裝頻道，確實很符合 AI 時代的做事方式。但這個方法偶爾會翻車，AI 可能理解錯你的意思。

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

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

openclaw channels add

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

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

接下來輸入你剛才保存的 App Secret 和 App ID，連接模式選擇WebSocket 長連接。

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

然后配置 DM 私聊的訪問控制方式，建議選擇配對碼模式，這樣只有通過配對碼驗證的用戶才能跟機器人私聊，更安全。當然這里跳過也行，后面隨時能改：

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

三、配置飛書事件

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

回到飛書開發(fā)者后臺，進入「事件與回調(diào)」配置，開啟長連接的事件訂閱方式：

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

添加好的事件列表如圖：

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

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

這次更新版本會自動審核通過：

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

四、私聊配對

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

隨便跟小龍蝦說一句話，比如：我要驗牌。

發(fā)送第一條消息后，機器人會返回一個配對碼：

拿到配對碼后，有兩種方式完成配對。

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

直接在 OpenClaw 網(wǎng)頁端把配對信息發(fā)給 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

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

openclaw pairing approve feishu 
<配對碼>

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

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

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

五、解鎖多媒體能力

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

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

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

發(fā)送圖片

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

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

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

執(zhí)行過程中它可能會找你人工確認操作。安全起見，建議大家一步一步來，防止 AI 誤操作或者浪費 Tokens。

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

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

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

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

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

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

我通過飛書跟小龍蝦說：

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

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

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

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

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

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

AI 代理的技能：

OpenClaw 全局技能管理：

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

魚皮的「看家蝦」已上線：

錄制音頻并發(fā)送

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

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

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

錄制視頻并發(fā)送

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

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

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

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

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

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

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

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

如果你的龍蝦不聽話，直接在飛書里讓它去修復(fù)對應(yīng)的問題就好，語氣可以強硬一點，它不會介意的。

實用小技巧 - 斜杠命令

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

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

1、斜杠命令 /new：新開一個對話

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

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

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

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

最后

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

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

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

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