Clawdbot 教程 02：如何集成飛書，完全國(guó)產(chǎn)化！

昨天 Clawdbot 2026.2.2 更新官方支持了飛書的集成插件。

這代表著國(guó)內(nèi)用 Clawdbot 完全可以使用國(guó)產(chǎn)的整個(gè)流程去替代了。

你可以用國(guó)產(chǎn)的模型，然后連接到飛書，完全不用擔(dān)心網(wǎng)絡(luò)問題。

然后飛書還能用群聊跟很多人聊天，非常好玩，Clawdbot 的應(yīng)用性拉滿了。

第一步：在飛書開發(fā)者后臺(tái)創(chuàng)建機(jī)器人

去飛書開發(fā)者后臺(tái)，創(chuàng)建一個(gè)新的機(jī)器人應(yīng)用。這一步很簡(jiǎn)單，填寫應(yīng)用名稱、應(yīng)用描述，選個(gè)背景色和圖標(biāo)就行。

創(chuàng)建完成后，你需要記下兩個(gè)關(guān)鍵信息：App ID 和 App Secret。

這兩個(gè) ID 在后面配置 Clawdbot 的時(shí)候要用到，都在「憑證與基礎(chǔ)信息 - 應(yīng)用憑證」這里能找到。

配置飛書機(jī)器人權(quán)限

進(jìn)入權(quán)限管理，找到「批量導(dǎo)入導(dǎo)出權(quán)限」，權(quán)限配置 JSON，直接復(fù)制過來，點(diǎn)擊導(dǎo)入。在 Clawdbot 官方文檔的飛書配置頁(yè)面有現(xià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",
      "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"]
}
}

導(dǎo)入完成后，點(diǎn)擊「確認(rèn)新增權(quán)限」就完成了權(quán)限配置。這一步是為了讓機(jī)器人有接收消息、發(fā)送消息等必要的權(quán)限。

開啟機(jī)器人能力

在「機(jī)器人」配置頁(yè)面，點(diǎn)擊「如何開始使用」，隨便輸入一句歡迎語（比如"你好，我是 AI 助手"），然后點(diǎn)擊保存，機(jī)器人能力就開啟了。

這一步是飛書機(jī)器人平臺(tái)的必要配置，不開啟的話后面無法接收消息。

第二步：在 Clawdbot 里配置飛書 Channel

這部分在 Clawdbot 本地完成，坑比較多，要注意幾個(gè)關(guān)鍵點(diǎn)。

運(yùn)行安裝向?qū)?/p>

在終端運(yùn)行 openclaw channels add 命令，會(huì)啟動(dòng)一個(gè)交互式向?qū)А＿x擇飛書（Feishu/Lark）選項(xiàng)，因?yàn)轱w書支持是通過 plugin 實(shí)現(xiàn)的，所以它會(huì)自動(dòng)下載插件。

這里第一個(gè)坑來了：如果提示"插件已存在"，然后又跳回上一層選項(xiàng)菜單，說明之前安裝過但沒安裝成功。你需要手動(dòng)去對(duì)應(yīng)的文件夾刪除這個(gè)插件文件夾，刪除后重新運(yùn)行 openclaw channels add 命令。

系統(tǒng)會(huì)告訴你插件在哪個(gè)目錄，按照提示去那個(gè)目錄刪掉整個(gè)插件文件夾就行。

解決 zod 依賴缺失問題

刪除插件重新安裝后，它會(huì)問你是否用 npm 安裝這個(gè)插件，選擇確定。這時(shí)候第二個(gè)坑來了：會(huì)提示缺少 zod 依賴。

正常情況下應(yīng)該在當(dāng)前文件夾安裝 zod 依賴就行，但問題是如果你已經(jīng)有了插件文件夾，它不讓你安裝；如果你刪了插件文件夾，zod 依賴也被刪了。這是個(gè)已知的 bug，很多人在報(bào)。

解決方案是全局安裝 zod 依賴，運(yùn)行這個(gè)命令：npm install -g zod

安裝完成后，再重新運(yùn)行 openclaw channels add 命令，選擇飛書，這次就能順利進(jìn)行了。

填寫配置信息

安裝成功后，會(huì)讓你填寫幾個(gè)配置項(xiàng)：

? Feishu account id：這個(gè)是用來區(qū)分多個(gè)飛書機(jī)器人的，隨便填一個(gè)名字就行，比如"my-bot"

? 選擇飛書版本：中國(guó)版飛書還是海外版 Lark，根據(jù)你的實(shí)際情況選擇，國(guó)內(nèi)用戶選中國(guó)版

? 填寫 App ID 和 App Secret：把之前在飛書開發(fā)者后臺(tái)獲取的兩個(gè) ID 填進(jìn)去

填寫完成后，注意一定要選擇「Finished」才算添加成功。我剛開始就是沒點(diǎn)這個(gè)，結(jié)果一直沒添加上，這是個(gè)容易忽略的細(xì)節(jié)。

配置私信訪問策略

接下來會(huì)問你幾個(gè)配置問題：

? Configure DM access policies now? 選擇 Yes

? Feishu DM policy：選擇 Pairing（推薦，需要配對(duì)碼才能使用）

? Add display names for these accounts?：選擇 No（可選）

這幾個(gè)配置按推薦選項(xiàng)走就行，主要是控制誰能跟機(jī)器人私聊。

重啟網(wǎng)關(guān)

所有配置完成后，運(yùn)行 openclaw gateway restart 命令重啟網(wǎng)關(guān)。這一步是讓新的 channel 配置生效，必須重啟才能建立連接。

第三步：回到飛書平臺(tái)完成最后配置

現(xiàn)在需要回到飛書開發(fā)者后臺(tái)做最后的設(shè)置。

配置事件訂閱方式

進(jìn)入「事件與回調(diào)」頁(yè)面，在「事件配置」里找到「訂閱方式」，選擇「使用長(zhǎng)連接接收事件」，然后點(diǎn)擊保存。

這里可能會(huì)提示"沒有建立長(zhǎng)連接"，不要慌，等一兩分鐘再點(diǎn)保存就行。如果等了幾分鐘還是不行，可能需要檢查一下 Clawdbot 的日志，看看是不是網(wǎng)關(guān)沒正常啟動(dòng)。

如果你按照我前面的步驟操作，一般不會(huì)有問題。

添加接收消息事件

在「事件配置」頁(yè)面，點(diǎn)擊「添加事件」，搜索 im.message.receive_v1 這個(gè)事件，點(diǎn)擊添加。這個(gè)事件是用來接收用戶發(fā)送的私信消息的，不添加的話機(jī)器人收不到消息。

發(fā)布版本

進(jìn)入「版本管理與發(fā)布」頁(yè)面，點(diǎn)擊「創(chuàng)建版本」，然后點(diǎn)擊「發(fā)布」。如果你沒有發(fā)布版本，系統(tǒng)會(huì)有提示引導(dǎo)你去創(chuàng)建，跟著提示走就行。

只有發(fā)布了版本，機(jī)器人的配置才會(huì)真正生效。

第四步：配對(duì)機(jī)器人

現(xiàn)在機(jī)器人已經(jīng)可以用了，最后一步是完成配對(duì)。

在飛書里找到你剛創(chuàng)建的機(jī)器人，發(fā)送一條消息，它會(huì)自動(dòng)回復(fù)一個(gè)配對(duì)碼，類似這樣的格式：pair:XXXXXX。

復(fù)制這個(gè)配對(duì)碼，打開 Clawdbot 的 Web UI（就是你平時(shí)跟 Clawdbot 對(duì)話的網(wǎng)頁(yè)），把配對(duì)碼發(fā)給它，Clawdbot 會(huì)自動(dòng)完成綁定。

綁定成功后，你就可以在飛書里跟 Clawdbot 愉快交流了，也可以把機(jī)器人拉到公司群里，讓所有小伙伴都能用。

配置完成后，你的飛書機(jī)器人就能正常工作了。

如果你用的是國(guó)產(chǎn)模型（比如通過 API 接入的minimax、kimi、GLM等），整套方案就完全是國(guó)產(chǎn)化的了。

要注意的幾個(gè)關(guān)鍵點(diǎn)：

? zod 依賴缺失的問題，記得全局安裝

? 添加 channel 后一定要點(diǎn) Finished

? 配置長(zhǎng)連接后等一兩分鐘再保存

? 記得發(fā)布機(jī)器人版本，否則配置不生效

整個(gè)配置流程雖然有幾個(gè)坑，但都有明確的解決方案，按照步驟來基本不會(huì)卡住。

好了，這就是今天的 Clawdbot 飛書配置流程。

如果你覺得對(duì)你有幫助的話，可以幫我點(diǎn)個(gè)贊，也可以轉(zhuǎn)發(fā)給其他你覺得需要的朋友們。