Clawdbot 教程 02：如何集成飛書，完全國產化！

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

這代表著國內用 Clawdbot 完全可以使用國產的整個流程去替代了。

你可以用國產的模型，然后連接到飛書，完全不用擔心網絡問題。

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

第一步：在飛書開發者后臺創建機器人

去飛書開發者后臺，創建一個新的機器人應用。這一步很簡單，填寫應用名稱、應用描述，選個背景色和圖標就行。

創建完成后，你需要記下兩個關鍵信息：App ID 和 App Secret。

這兩個 ID 在后面配置 Clawdbot 的時候要用到，都在「憑證與基礎信息 - 應用憑證」這里能找到。

配置飛書機器人權限

進入權限管理，找到「批量導入導出權限」，權限配置 JSON，直接復制過來，點擊導入。在 Clawdbot 官方文檔的飛書配置頁面有現成的，全選導入就可以了。

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

導入完成后，點擊「確認新增權限」就完成了權限配置。這一步是為了讓機器人有接收消息、發送消息等必要的權限。

開啟機器人能力

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

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

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

這部分在 Clawdbot 本地完成，坑比較多，要注意幾個關鍵點。

運行安裝向導命令

在終端運行 openclaw channels add 命令，會啟動一個交互式向導。選擇飛書（Feishu/Lark）選項，因為飛書支持是通過 plugin 實現的，所以它會自動下載插件。

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

系統會告訴你插件在哪個目錄，按照提示去那個目錄刪掉整個插件文件夾就行。

解決 zod 依賴缺失問題

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

正常情況下應該在當前文件夾安裝 zod 依賴就行，但問題是如果你已經有了插件文件夾，它不讓你安裝；如果你刪了插件文件夾，zod 依賴也被刪了。這是個已知的 bug，很多人在報。

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

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

填寫配置信息

安裝成功后，會讓你填寫幾個配置項：

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

? 選擇飛書版本：中國版飛書還是海外版 Lark，根據你的實際情況選擇，國內用戶選中國版

? 填寫 App ID 和 App Secret：把之前在飛書開發者后臺獲取的兩個 ID 填進去

填寫完成后，注意一定要選擇「Finished」才算添加成功。我剛開始就是沒點這個，結果一直沒添加上，這是個容易忽略的細節。

配置私信訪問策略

接下來會問你幾個配置問題：

? Configure DM access policies now? 選擇 Yes

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

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

這幾個配置按推薦選項走就行，主要是控制誰能跟機器人私聊。

重啟網關

所有配置完成后，運行 openclaw gateway restart 命令重啟網關。這一步是讓新的 channel 配置生效，必須重啟才能建立連接。

第三步：回到飛書平臺完成最后配置

現在需要回到飛書開發者后臺做最后的設置。

配置事件訂閱方式

進入「事件與回調」頁面，在「事件配置」里找到「訂閱方式」，選擇「使用長連接接收事件」，然后點擊保存。

這里可能會提示"沒有建立長連接"，不要慌，等一兩分鐘再點保存就行。如果等了幾分鐘還是不行，可能需要檢查一下 Clawdbot 的日志，看看是不是網關沒正常啟動。

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

添加接收消息事件

在「事件配置」頁面，點擊「添加事件」，搜索 im.message.receive_v1 這個事件，點擊添加。這個事件是用來接收用戶發送的私信消息的，不添加的話機器人收不到消息。

發布版本

進入「版本管理與發布」頁面，點擊「創建版本」，然后點擊「發布」。如果你沒有發布版本，系統會有提示引導你去創建，跟著提示走就行。

只有發布了版本，機器人的配置才會真正生效。

第四步：配對機器人

現在機器人已經可以用了，最后一步是完成配對。

在飛書里找到你剛創建的機器人，發送一條消息，它會自動回復一個配對碼，類似這樣的格式：pair:XXXXXX。

復制這個配對碼，打開 Clawdbot 的 Web UI（就是你平時跟 Clawdbot 對話的網頁），把配對碼發給它，Clawdbot 會自動完成綁定。

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

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

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

要注意的幾個關鍵點：

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

? 添加 channel 后一定要點 Finished

? 配置長連接后等一兩分鐘再保存

? 記得發布機器人版本，否則配置不生效

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

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

如果你覺得對你有幫助的話，可以幫我點個贊，也可以轉發給其他你覺得需要的朋友們。