🔧 阿川の電商水電行

Shopify 顧問、維護與客製化

💡

小任務 / 單次支援方案

單次處理 Shopify 修正／微調

⭐️

維護方案

每月 Shopify 技術支援 + 小修改 + 諮詢

🚀

專案建置

Shopify 功能導入、培訓 + 分階段交付

👉 瞭解詳情 / 免費諮詢

小編精選 - 技術文章翻譯 · 03月06日

OpenClaw 連線飛書完整指南：外掛安裝、設定與踩坑記錄

OpenClaw 連接飛書完整指南：插件安裝、配置與踩坑記錄

摘要：本文詳細記錄使用 OpenClaw 連接飛書機器人的過程，包括插件安裝失敗、配置錯誤等常見問題的解決方案。

前言

最近在使用 OpenClaw 連接飛書機器人時遇到了一系列問題，網上相關資料較少，特此記錄完整解決方案，幫助有同樣需求的同學少走彎路。

環境信息

OpenClaw 版本: latest
Node.js: v22.22.0
操作系統: Windows 11
飛書應用類型: 企業內部應用

問題一：官方飛書插件安裝失敗

現象

按照文檔嘗試安裝飛書插件：

openclaw plugins install feishu

錯誤信息：

Error: Cannot find package '@openclaw/plugin-feishu'
npm ERR! 404 Not Found

原因分析

OpenClaw 官方 npm 倉庫中並沒有發布 @openclaw/plugin-feishu 包，文檔中提到的飛書插件需要單獨安裝。

解決方案

使用第三方開源插件：

openclaw plugins install https://github.com/AlexAnys/openclaw-feishu

驗證安裝：

openclaw plugins list

看到列表中有 feishu 即表示安裝成功。

問題二：配置後機器人聊天口沒有

遇到這種情況只要把事件配置裡的訂閱方式長連接配置好，再發布就可以了。

現象

插件安裝成功後，配置了 App ID 和 App Secret，但發送消息時報錯：

Feishu account 'default' not configured

飛書機器人聊天窗口也沒有任何響應。

錯誤配置示例 ❌

最初我這樣配置：

openclaw config set channels.feishu.app_id "cli_xxx"
openclaw config set channels.feishu.app_secret "xxx"
openclaw config set channels.feishu.domain "lark"  # 錯誤！應該是 feishu

原因分析

域名錯誤：飛書（Feishu）和 Lark 是字節跳動不同版本的產品
- 飛書（中國版）：domain = "feishu"
- Lark（國際版）：domain = "lark"
配置結構錯誤：插件需要 accounts 陣列格式，而不是頂層配置。

正確的配置方式 ✅

第一步：配置 accounts 陣列

# 配置帳號 ID
openclaw config set "accounts.feishu[0].id" "default"

# 配置 App ID
openclaw config set "accounts.feishu[0].app_id" "cli_xxx"

# 配置 App Secret
openclaw config set "accounts.feishu[0].app_secret" "xxx"

第二步：配置 channels 引用

# 配置域名（注意是 feishu 不是 lark）
openclaw config set "channels.feishu.accounts[0].domain" "feishu"

# 配置帳號引用
openclaw config set "channels.feishu.account" "default"

第三步：重啟 Gateway

openclaw gateway restart

問題三：飛書應用權限配置

必要權限

在飛書開放平台（open.feishu.cn/app）需要開啟以下權限：

機器人權限
- ✅ 機器人: 獲取以應用身份發送的消息
- ✅ 機器人: 在群組內發送和接受消息
即時消息權限
- ✅ 即時消息: 發送消息
群組權限
- ✅ 群組: 獲取群組信息

配置步驟

進入飛書開放平台 → 我的應用
點擊 權限管理
搜索並添加上述權限
點擊 申請權限 並提交
等待審核通過（企業應用通常自動通過）

最終完整配置

{
  "accounts": {
    "feishu": [
      {
        "id": "default",
        "app_id": "cli_xxx",
        "app_secret": "xxx"
      }
    ]
  },
  "channels": {
    "feishu": {
      "account": "default",
      "accounts": [
        {
          "id": "default",
          "domain": "feishu",
          "app_id": "cli_xxx",
          "app_secret": "xxx"
        }
      ]
    }
  }
}

測試發送消息

獲取群聊 ID

從飛書群鏈接中提取：

https://applink.feishu.cn/client/chat/chatter/add_by_link?link_token=f7ftd1a0-50db-46b7-8e86-40a7b731a10a

群 ID 為：f7ftd1a0-50db-46b7-8e86-40a7b731a10a

發送消息命令

openclaw message send \
  --channel feishu \
  --target "chat:f7ftd1a0-50db-46b7-8e86-40a7b731a10a" \
  --message "大家好，這是測試消息！"

或者在代碼中調用：

await message.send({
  channel: 'feishu',
  target: 'chat:f7ftd1a0-50db-46b7-8e86-40a7b731a10a',
  message: '大家好'
});

常見問題彙總

問題	原因	解決方案
插件安裝 404	官方包未發布	使用 GitHub 第三方插件
account not configured	配置結構錯誤	使用 `accounts.feishu[0]` 陣列格式
Invalid App Access Token	域名錯誤	`domain` 設為 `"feishu"` 不是 `"lark"`
消息發送失敗	權限未開啟	在飛書開放平台申請必要權限
配置不生效	未重啟 gateway	`openclaw gateway restart`