OpenClaw連接飛書插件安裝、配置與踩坑記錄完整指南
我要評論前言
最近在使用 OpenClaw 連接飛書機器人時遇到了一系列問題，網(wǎng)上相關資料較少，特此記錄完整解決方案，幫助有同樣需求的同學少走彎路。
環(huán)境信息
- OpenClaw 版本: latest
- Node.js: v22.22.0
- 操作系統(tǒng): Windows 11
- 飛書應用類型: 企業(yè)內(nèi)部應用
問題一：官方飛書插件安裝失敗
現(xiàn)象
按照文檔嘗試安裝飛書插件：
openclaw plugins install feishu
錯誤信息：
Error: Cannot find package '@openclaw/plugin-feishu' npm ERR! 404 Not Found
原因分析
OpenClaw 官方 npm 倉庫中并沒有發(fā)布 @openclaw/plugin-feishu 包，文檔中提到的飛書插件需要單獨安裝。
解決方案
使用第三方開源插件：
openclaw plugins install https://github.com/AlexAnys/openclaw-feishu
驗證安裝：
openclaw plugins list
看到列表中有 feishu 即表示安裝成功。
問題二：配置后機器人后機器人聊天口沒有
遇到這種情況只要把事件配置里的訂閱方式長連接配置好，再發(fā)布就可以了
現(xiàn)象
插件安裝成功后，配置了 App ID 和 App Secret，但發(fā)送消息時報錯：
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 是字節(jié)跳動不同版本的產(chǎn)品
- 飛書（中國版）：
domain = "feishu" - Lark（國際版）：
domain = "lark"
- 飛書（中國版）：
配置結構錯誤：插件需要
accounts數(shù)組格式，而不是頂層配置
正確的配置方式 ?
第一步：配置 accounts 數(shù)組
# 配置賬號 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）需要開啟以下權限：
機器人權限
- ? 機器人: 獲取以應用身份發(fā)送的消息
- ? 機器人: 在群組內(nèi)發(fā)送和接受消息
即時消息權限
- ? 即時消息: 發(fā)送消息
群組權限
- ? 群組: 獲取群組信息
配置步驟
- 進入飛書開放平臺 → 我的應用
- 點擊 權限管理
- 搜索并添加上述權限
- 點擊 申請權限 并提交
- 等待審核通過（企業(yè)應用通常自動通過）
最終完整配置
{
"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"
}
]
}
}
}測試發(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 "大家好，這是測試消息！"
或者在代碼中調(diào)用：
await message.send({
channel: 'feishu',
target: 'chat:f7ftd1a0-50db-46b7-8e86-40a7b731a10a',
message: '大家好'
});常見問題匯總
| 問題 | 原因 | 解決方案 |
|---|---|---|
| 插件安裝 404 | 官方包未發(fā)布 | 使用 GitHub 第三方插件 |
| account not configured | 配置結構錯誤 | 使用 accounts.feishu[0] 數(shù)組格式 |
| Invalid App Access Token | 域名錯誤 | domain 設為 "feishu" 不是 "lark" |
| 消息發(fā)送失敗 | 權限未開啟 | 在飛書開放平臺申請必要權限 |
| 配置不生效 | 未重啟 gateway | openclaw gateway restart |
總結
連接飛書的關鍵點：
- ? 使用正確的插件來源（GitHub 第三方插件）
- ? 配置正確的數(shù)據(jù)結構（
accounts數(shù)組格式） - ? 區(qū)分飛書和 Lark 的域名配置
- ? 確保飛書應用有足夠權限
- ? 每次配置修改后重啟 gateway
希望這篇文章能幫助你少走彎路！如果有問題歡迎在評論區(qū)交流。
參考鏈接
到此這篇關于OpenClaw連接飛書插件安裝、配置與踩坑記錄的文章就介紹到這了,更多相關OpenClaw連接飛書內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章，希望大家以后多多支持腳本之家！
相關文章
OpenClaw 是一個個人 AI 代理框架,支持連接多種聊天平臺（如飛書、Telegram 等）并集成多種模型,這篇文章主要介紹了OpenClaw飛書官方插件安裝教程的相關資料,文中通過代碼2026-03-27
ubuntu (V100)中 部署openclaw并鏈接飛書的操作方法
本文介紹了在Ubuntu上部署Ollama的大模型推理框架及OpenClaw的方法,包括編譯安裝Ollama、使用OpenClaw的安裝腳本和配置文件等步驟,并簡要介紹了OpenClaw的工作流程，感興趣2026-03-26
OpenClaw飛書渠道ACP功能啟動的實現(xiàn)步驟
OpenClaw 的 ACP機制允許將 Codex、Claude Code、Gemini CLI 等外部編程工具納入 OpenClaw 的 Agent 編排體系,很多讀者在飛書渠道部署 OpenClaw 后，想知道如何在這個環(huán)境2026-03-26
當你的 AI 助手突然聾了——能發(fā)消息卻收不到回復，問題可能藏在一個你根本不會去看的 .ts 文件里,下面小編就和大家詳細介紹一下OpenClaw飛書插件加載失敗的問題排查與解決2026-03-25
OpenClaw多渠道接入WhatsApp、Telegram、飛書的實戰(zhàn)指南
OpenClaw的Channels多渠道接入系統(tǒng)是其六層架構的第一層，負責連接外部消息平臺與AI Agent系統(tǒng),本文深入剖析Channels的核心概念、架構設計、與Gateway的交互機制，詳細介紹2026-03-23
最近在使用 OpenClaw 進行飛書機器人配對時，執(zhí)行命令時遇到了錯誤，同時啟動日志中反復出現(xiàn)警告這個問題的根本原因是 OpenClaw 環(huán)境中存在兩個 ID 相同的飛書插件，本文借2026-03-19
OpenClaw解決飛書 duplicate plugin id detected 問題
文章介紹了OpenClaw在啟動過程中檢測到重復的feishu插件ID并導致沖突的問題,通過查找和刪除全局插件文件并調(diào)整配置文件,成功解決了這個問題，感興趣的朋友跟隨小編一起看看2026-03-17
在Ubuntu上快速部署OpenClaw并接入飛書的完整過程
OpenClaw是一個可擴展的 AI 助手運行框架，核心目標是讓助手真正“能做事”,這篇文章主要介紹了在Ubuntu上快速部署OpenClaw并接入飛書的完整過程,文中通過圖文介紹的非常詳2026-03-13
本文詳細介紹如何將OpenClaw AI 智能體網(wǎng)關與飛書（Feishu）集成，實現(xiàn)企業(yè)內(nèi)部的 AI 助手功能,涵蓋飛書應用創(chuàng)建、權限配置、OpenClaw 連接和高級功能設置,本文給大家介紹2026-03-17
OpenClaw 從零配置指南并接入飛書 + 常用命令 + 原理全解析
本文介紹了如何從零配置OpenClaw并接入飛書,包括安裝、配置、權限設置、模型切換、技能管理等步驟,以及常用命令和配置文件說明，感興趣的朋友跟隨小編一起看看吧2026-03-12
