前言

最近在使用 OpenClaw 連接飛書機(jī)器人時(shí)遇到了一系列問(wèn)題，網(wǎng)上相關(guān)資料較少，特此記錄完整解決方案，幫助有同樣需求的同學(xué)少走彎路。

環(huán)境信息

• OpenClaw 版本: latest
• Node.js: v22.22.0
• 操作系統(tǒng): Windows 11
• 飛書應(yīng)用類型: 企業(yè)內(nèi)部應(yīng)用

問(wèn)題一：官方飛書插件安裝失敗

現(xiàn)象

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

openclaw plugins install feishu

錯(cuò)誤信息：

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

原因分析

OpenClaw 官方 npm 倉(cāng)庫(kù)中并沒(méi)有發(fā)布 @openclaw/plugin-feishu 包，文檔中提到的飛書插件需要單獨(dú)安裝。

解決方案

使用第三方開源插件：

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

驗(yàn)證安裝：

openclaw plugins list

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

問(wèn)題二：配置后機(jī)器人后機(jī)器人聊天口沒(méi)有

遇到這種情況只要把事件配置里的訂閱方式長(zhǎng)連接配置好，再發(fā)布就可以了

現(xiàn)象

插件安裝成功后，配置了 App ID 和 App Secret，但發(fā)送消息時(shí)報(bào)錯(cuò)：

Feishu account 'default' not configured

飛書機(jī)器人聊天窗口也沒(méi)有任何響應(yīng)。

錯(cuò)誤配置示例 ?

最初我這樣配置：

openclaw config set channels.feishu.app_id "cli_xxx"
openclaw config set channels.feishu.app_secret "xxx"
openclaw config set channels.feishu.domain "lark" ?# 錯(cuò)誤！應(yīng)該是 feishu

原因分析

0. 域名錯(cuò)誤：飛書（Feishu）和 Lark 是字節(jié)跳動(dòng)不同版本的產(chǎn)品

   • 飛書（中國(guó)版）：domain = "feishu"
   • Lark（國(guó)際版）：domain = "lark"

1. 配置結(jié)構(gòu)錯(cuò)誤：插件需要 accounts 數(shù)組格式，而不是頂層配置

正確的配置方式 ?

第一步：配置 accounts 數(shù)組

# 配置賬號(hào) 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"
?
# 配置賬號(hào)引用
openclaw config set "channels.feishu.account" "default"

第三步：重啟 Gateway

openclaw gateway restart

問(wèn)題三：飛書應(yīng)用權(quán)限配置

必要權(quán)限

在飛書開放平臺(tái)（open.feishu.cn/app）需要開啟以下權(quán)限：

0. 機(jī)器人權(quán)限

   • ? 機(jī)器人: 獲取以應(yīng)用身份發(fā)送的消息
   • ? 機(jī)器人: 在群組內(nèi)發(fā)送和接受消息

1. 即時(shí)消息權(quán)限

   • ? 即時(shí)消息: 發(fā)送消息

2. 群組權(quán)限

   • ? 群組: 獲取群組信息

配置步驟

0. 進(jìn)入飛書開放平臺(tái) → 我的應(yīng)用
1. 點(diǎn)擊 權(quán)限管理
2. 搜索并添加上述權(quán)限
3. 點(diǎn)擊 申請(qǐng)權(quán)限 并提交
4. 等待審核通過(guò)（企業(yè)應(yīng)用通常自動(dòng)通過(guò)）

最終完整配置

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

測(cè)試發(fā)送消息

獲取群聊 ID

從飛書群鏈接中提?。?/p>

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

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

發(fā)送消息命令

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

或者在代碼中調(diào)用：

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

常見問(wèn)題匯總

總結(jié)

連接飛書的關(guān)鍵點(diǎn)：

0. ? 使用正確的插件來(lái)源（GitHub 第三方插件）
1. ? 配置正確的數(shù)據(jù)結(jié)構(gòu)（accounts 數(shù)組格式）
2. ? 區(qū)分飛書和 Lark 的域名配置
3. ? 確保飛書應(yīng)用有足夠權(quán)限
4. ? 每次配置修改后重啟 gateway

希望這篇文章能幫助你少走彎路！如果有問(wèn)題歡迎在評(píng)論區(qū)交流。

參考鏈接

• OpenClaw 官方文檔
• 飛書開放平臺(tái)
• openclaw-feishu 插件源碼
• 飛書 API 文檔

到此這篇關(guān)于OpenClaw連接飛書插件安裝、配置與踩坑記錄的文章就介紹到這了,更多相關(guān)OpenClaw連接飛書內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評(píng)論