當我把 OpenClaw 接入飛書，它開始用我的攝像頭搞事了！

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

最近 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:、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 費用。

2、斜杠命令 /verbose：開啟調試模式

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

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

最后

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

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

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

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