openclaw配置飛書的完整教程
OpenClaw 配置飛書(Feishu)完整教程 | 打造企業(yè)級 AI 智能助手
摘要:本文詳細(xì)介紹如何將 OpenClaw AI 智能體網(wǎng)關(guān)與飛書(Feishu)集成,實現(xiàn)企業(yè)內(nèi)部的 AI 助手功能。涵蓋飛書應(yīng)用創(chuàng)建、權(quán)限配置、OpenClaw 連接和高級功能設(shè)置。
一、什么是飛書集成
OpenClaw 支持將 AI 智能體連接到飛書(Feishu/Lark)企業(yè)聊天平臺,通過機器人形式提供:
- ?? 智能問答:員工可直接與 AI 對話
- ?? 文檔處理:讀寫飛書文檔、知識庫
- ?? 云盤管理:操作飛書云空間文件
- ?? 群組協(xié)作:在群聊中提供 AI 支持
- ?? 權(quán)限控制:企業(yè)級訪問控制
二、系統(tǒng)要求
| 項目 | 要求 |
|---|---|
| OpenClaw | 最新版本 |
| 飛書賬號 | 企業(yè)管理員或應(yīng)用創(chuàng)建權(quán)限 |
| Node.js | 22.0+ |
| 網(wǎng)絡(luò) | 可訪問飛書開放平臺 |
?? 注意:飛書集成需要企業(yè)管理員權(quán)限創(chuàng)建應(yīng)用,個人賬號可能受限。
三、安裝 OpenClaw(如未安裝)
3.1 Windows 安裝
iwr -useb https://openclaw.ai/install.ps1 | iex
3.2 macOS/Linux 安裝
curl -fsSL https://openclaw.ai/install.sh | bash
3.3 驗證安裝
openclaw --version openclaw gateway status
四、創(chuàng)建飛書應(yīng)用
4.1 訪問飛書開放平臺
- 國內(nèi)版:https://open.feishu.cn/app
- 國際版(Lark):https://open.larksuite.com/app
登錄企業(yè)飛書賬號。
4.2 創(chuàng)建企業(yè)應(yīng)用
- 點擊 創(chuàng)建企業(yè)應(yīng)用
- 填寫應(yīng)用信息:
- 應(yīng)用名稱:
AI 助手(或自定義) - 應(yīng)用描述:
OpenClaw AI 智能助手 - 應(yīng)用圖標(biāo):上傳一個圖標(biāo)(可選)
- 應(yīng)用名稱:

4.3 獲取應(yīng)用憑證
在 憑證與基礎(chǔ)信息 頁面,復(fù)制:
- App ID(格式:
cli_xxxxxxxxxxxx) - App Secret(點擊復(fù)制)
?? 重要:App Secret 是敏感信息,請妥善保管,不要泄露!

五、配置應(yīng)用權(quán)限
5.1 批量導(dǎo)入權(quán)限
在 權(quán)限管理 頁面,點擊 批量導(dǎo)入,粘貼以下 JSON:
{
"scopes": {
"tenant": [
"aily:file:read",
"aily:file:write",
"application:application.app_message_stats.overview:readonly",
"application:application:self_manage",
"application:bot.menu:write",
"cardkit:card:read",
"cardkit:card: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"]
}
}
5.2 啟用機器人能力
- 進入 應(yīng)用能力 → 機器人
- 開啟機器人能力
- 設(shè)置機器人名稱(如:
AI 助手) - 下圖是啟用之后的截圖

5.3 配置事件訂閱
?? 重要:在配置事件訂閱前,確保:
- 已運行
openclaw channels add添加飛書渠道 - Gateway 已啟動(
openclaw gateway status)
配置步驟:
- 進入 事件訂閱 頁面
- 選擇 使用長連接接收事件(WebSocket 模式)
- 添加事件:
im.message.receive_v1

- 如何配置長連接事件這邊使用的node.js方法
復(fù)制node代碼到本地新建一個index.js
import * as Lark from '@larksuiteoapi/node-sdk';
const baseConfig = {
appId: '上圖中的api-key',
appSecret: '上圖中的pai-secret'
}
const client = new Lark.Client(baseConfig);
const wsClient = new Lark.WSClient({...baseConfig, loggerLevel: Lark.LoggerLevel.debug});
wsClient.start({
// 處理「接收消息」事件,事件類型為 im.message.receive_v1
eventDispatcher: new Lark.EventDispatcher({}).register({
'im.message.receive_v1': async (data) => {
const {
message: { chat_id, content}
} = data;
// 示例操作:接收消息后,調(diào)用「發(fā)送消息」API 進行消息回復(fù)。
await client.im.v1.message.create({
params: {
receive_id_type: "chat_id"
},
data: {
receive_id: chat_id,
content: Lark.messageCard.defaultCard({
title: `回復(fù): ${JSON.parse(content).text}`,
content: '新年好'
}),
msg_type: 'interactive'
}
});
}
})
});- 之后在命令框運行
npm install @larksuiteoapi/node-sdk
- 最后運行
npm index.js
- 運行之后就可以在飛書開放平臺進行驗證長連接了
5.4 發(fā)布應(yīng)用
進入 版本管理與發(fā)布

- 創(chuàng)建新版本
- 提交審核并發(fā)布
- 等待管理員審批(企業(yè)應(yīng)用通常自動通過)
六、配置 OpenClaw
6.1 使用向?qū)渲茫ㄍ扑])
openclaw channels add
選擇 Feishu,然后輸入:
- App ID
- App Secret
向?qū)詣油瓿膳渲谩?/p>
6.2 手動配置文件
編輯 ~/.openclaw/openclaw.json:
{
"channels": {
"feishu": {
"enabled": true,
"dmPolicy": "pairing",
"domain": "feishu",
"accounts": {
"main": {
"appId": "cli_xxxxxxxxxxxx",
"appSecret": "your_app_secret_here",
"botName": "AI 助手"
}
}
}
}
}6.3 國際版(Lark)配置
如果使用飛書國際版:
{
"channels": {
"feishu": {
"domain": "lark",
"accounts": {
"main": {
"appId": "cli_xxxxxxxxxxxx",
"appSecret": "your_app_secret_here"
}
}
}
}
}七、啟動并測試
7.1 啟動 Gateway
openclaw gateway
或檢查服務(wù)狀態(tài):
openclaw gateway status
7.2 在飛書中添加機器人
- 打開飛書
- 搜索你的機器人名稱(如
AI 助手) - 發(fā)送一條測試消息
7.3 配對授權(quán)
首次使用時,機器人會回復(fù)一個配對碼。在終端執(zhí)行:
openclaw pairing list feishu openclaw pairing approve feishu <配對碼>
配對成功后即可正常對話。
八、訪問控制配置
8.1 私聊控制(dmPolicy)
| 模式 | 說明 |
|---|---|
pairing(默認(rèn)) | 未知用戶需配對授權(quán) |
allowlist | 僅允許指定用戶 |
open | 允許所有用戶 |
disabled | 禁用私聊 |
白名單模式示例:
{
"channels": {
"feishu": {
"dmPolicy": "allowlist",
"allowFrom": ["ou_xxxxxx1", "ou_xxxxxx2"]
}
}
}8.2 群聊控制(groupPolicy)
| 模式 | 說明 |
|---|---|
open(默認(rèn)) | 允許所有群聊 |
allowlist | 僅允許指定群聊 |
disabled | 禁用群聊 |
允許特定群聊:
{
"channels": {
"feishu": {
"groupPolicy": "allowlist",
"groupAllowFrom": ["oc_xxxxxx1", "oc_xxxxxx2"]
}
}
}8.3 群組提及設(shè)置
默認(rèn)需要 @機器人 才響應(yīng),可配置為始終響應(yīng):
{
"channels": {
"feishu": {
"groups": {
"oc_xxxxxx": {
"requireMention": false
}
}
}
}
}九、獲取用戶和群組 ID
9.1 獲取用戶 Open ID
方法 1:查看日志
- 用戶發(fā)送消息給機器人
- 運行
openclaw logs --follow - 查找
open_id(格式:ou_xxxxxxxxxxxx)
方法 2:查看配對請求
openclaw pairing list feishu
9.2 獲取群組 Chat ID
方法 1:查看日志
- 在群聊中 @機器人
- 運行
openclaw logs --follow - 查找
chat_id(格式:oc_xxxxxxxxxxxx)
方法 2:使用飛書 API 調(diào)試工具
十、高級功能
10.1 多賬號配置
{
"channels": {
"feishu": {
"defaultAccount": "main",
"accounts": {
"main": {
"appId": "cli_xxx1",
"appSecret": "secret1",
"botName": "主助手"
},
"backup": {
"appId": "cli_xxx2",
"appSecret": "secret2",
"botName": "備用助手",
"enabled": false
}
}
}
}
}10.2 多智能體路由
根據(jù)不同用戶/群組路由到不同 AI 智能體:
{
"agents": {
"list": [
{ "id": "main" },
{ "id": "hr-assistant", "workspace": "~/.openclaw/workspace-hr" },
{ "id": "tech-support", "workspace": "~/.openclaw/workspace-tech" }
]
},
"bindings": [
{
"agentId": "main",
"match": {
"channel": "feishu",
"peer": { "kind": "direct", "id": "ou_xxx" }
}
},
{
"agentId": "hr-assistant",
"match": {
"channel": "feishu",
"peer": { "kind": "group", "id": "oc_hr_group" }
}
},
{
"agentId": "tech-support",
"match": {
"channel": "feishu",
"peer": { "kind": "group", "id": "oc_tech_group" }
}
}
]
}10.3 流式輸出配置
{
"channels": {
"feishu": {
"streaming": true,
"blockStreaming": true
}
}
}streaming: true:啟用流式卡片輸出blockStreaming: true:啟用塊級流式更新
10.4 性能優(yōu)化
{
"channels": {
"feishu": {
"typingIndicator": false,
"resolveSenderNames": false,
"textChunkLimit": 2000,
"mediaMaxMb": 30
}
}
}typingIndicator: false:禁用輸入中提示(減少 API 調(diào)用)resolveSenderNames: false:禁用發(fā)送者名稱解析
十一、飛書工具集成
OpenClaw 飛書集成支持以下工具:
11.1 文檔工具(feishu-doc)
- 讀取/寫入飛書文檔
- 創(chuàng)建表格
- 上傳圖片/附件
- 支持 Markdown 格式
示例:
幫我讀取這個文檔:https://xxx.feishu.cn/docx/ABC123def
11.2 云盤工具(feishu-drive)
- 列出文件夾內(nèi)容
- 創(chuàng)建文件夾
- 移動/刪除文件
- 獲取文件信息
示例:
查看我的云盤根目錄 在云盤創(chuàng)建一個新文件夾"項目文檔"
11.3 權(quán)限工具(feishu-perm)
- 查看協(xié)作者列表
- 添加/移除協(xié)作者
- 設(shè)置權(quán)限級別
示例:
給這個文檔添加協(xié)作者:alice@company.com,編輯權(quán)限
?? 注意:權(quán)限工具默認(rèn)禁用,需在配置中顯式啟用。
11.4 知識庫工具(feishu-wiki)
- 瀏覽知識庫空間
- 創(chuàng)建/移動/重命名節(jié)點
- 讀寫知識庫頁面
示例:
列出所有知識庫空間 在"技術(shù)文檔"空間創(chuàng)建一個新頁面
十二、常用命令
# 查看網(wǎng)關(guān)狀態(tài) openclaw gateway status # 重啟網(wǎng)關(guān) openclaw gateway restart # 查看日志 openclaw logs --follow # 查看配對請求 openclaw pairing list feishu # 批準(zhǔn)配對 openclaw pairing approve feishu <CODE> # 拒絕配對 openclaw pairing reject feishu <CODE> # 添加飛書渠道 openclaw channels add # 健康檢查 openclaw health
十三、常見問題
Q1: 機器人不回復(fù)消息
檢查:
- 應(yīng)用是否已發(fā)布并審批通過
- 事件訂閱是否包含
im.message.receive_v1 - 長連接是否已啟用
- 應(yīng)用權(quán)限是否完整
- Gateway 是否運行:
openclaw gateway status - 查看日志:
openclaw logs --follow
Q2: 群聊中機器人不響應(yīng)
檢查:
- 機器人是否已添加到群聊
- 是否 @機器人(默認(rèn)需要)
groupPolicy是否設(shè)置為disabled- 查看日志確認(rèn)消息是否收到
Q3: 長連接配置失敗
解決:
- 確保 Gateway 已啟動
- 先運行
openclaw channels add - 再在飛書后臺配置事件訂閱
- 檢查網(wǎng)絡(luò)是否可訪問飛書 API
Q4: App Secret 泄露
緊急處理:
- 在飛書開放平臺重置 App Secret
- 更新 OpenClaw 配置
- 重啟 Gateway
Q5: 權(quán)限不足錯誤
解決:
- 檢查應(yīng)用權(quán)限是否完整導(dǎo)入
- 確認(rèn)應(yīng)用已發(fā)布
- 查看日志中的具體權(quán)限錯誤
- 在飛書后臺補充缺失權(quán)限
十四、安全建議
- 配置白名單:限制可訪問的用戶和群組
- 群組提及:設(shè)置
requireMention: true避免干擾 - 定期更新:
npm update -g openclaw - 備份配置:定期備份
~/.openclaw/目錄 - 監(jiān)控日志:定期檢查
openclaw logs - 權(quán)限最小化:只申請必要的 API 權(quán)限
十五、配置文件參考
完整配置示例:
{
"channels": {
"feishu": {
"enabled": true,
"domain": "feishu",
"connectionMode": "websocket",
"defaultAccount": "main",
"dmPolicy": "pairing",
"allowFrom": [],
"groupPolicy": "open",
"groupAllowFrom": [],
"groups": {
"oc_xxxxxx": {
"requireMention": true,
"enabled": true,
"allowFrom": ["ou_user1", "ou_user2"]
}
},
"streaming": true,
"blockStreaming": true,
"typingIndicator": true,
"resolveSenderNames": true,
"textChunkLimit": 2000,
"mediaMaxMb": 30,
"accounts": {
"main": {
"appId": "cli_xxxxxxxxxxxx",
"appSecret": "your_app_secret",
"botName": "AI 助手",
"domain": "feishu"
}
}
}
}
}十六、資源鏈接
- ?? 飛書開放平臺:https://open.feishu.cn/
- ?? OpenClaw 文檔:https://docs.openclaw.ai
- ?? GitHub 倉庫:https://github.com/openclaw/openclaw
- ?? Discord 社區(qū):https://discord.com/invite/clawd
- ?? 技能市場:https://clawhub.com
總結(jié)
OpenClaw 飛書集成提供了強大的企業(yè)級 AI 助手能力:
? 快速集成:15 分鐘完成配置
? 安全可靠:企業(yè)級權(quán)限控制
? 功能豐富:文檔、云盤、知識庫全支持
? 靈活配置:多賬號、多智能體路由
? 易于管理:完善的日志和監(jiān)控
配置完成后,你的企業(yè)員工可以通過飛書隨時隨地與 AI 助手交互,提升工作效率。
到此這篇關(guān)于openclaw配置飛書的完整教程的文章就介紹到這了,更多相關(guān)openclaw配置飛書內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章,希望大家以后多多支持腳本之家!
相關(guān)文章
OpenClaw 是一個個人 AI 代理框架,支持連接多種聊天平臺(如飛書、Telegram 等)并集成多種模型,這篇文章主要介紹了OpenClaw飛書官方插件安裝教程的相關(guān)資料,文中通過代碼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
當(dāng)你的 AI 助手突然聾了——能發(fā)消息卻收不到回復(fù),問題可能藏在一個你根本不會去看的 .ts 文件里,下面小編就和大家詳細(xì)介紹一下OpenClaw飛書插件加載失敗的問題排查與解決2026-03-25
OpenClaw多渠道接入WhatsApp、Telegram、飛書的實戰(zhàn)指南
OpenClaw的Channels多渠道接入系統(tǒng)是其六層架構(gòu)的第一層,負(fù)責(zé)連接外部消息平臺與AI Agent系統(tǒng),本文深入剖析Channels的核心概念、架構(gòu)設(shè)計、與Gateway的交互機制,詳細(xì)介紹2026-03-23
OpenClaw飛書插件沖突導(dǎo)致的配對失敗問題的解決方案
最近在使用 OpenClaw 進行飛書機器人配對時,執(zhí)行命令時遇到了錯誤,同時啟動日志中反復(fù)出現(xiàn)警告這個問題的根本原因是 OpenClaw 環(huán)境中存在兩個 ID 相同的飛書插件,本文借2026-03-19
OpenClaw解決飛書 duplicate plugin id detected 問題
文章介紹了OpenClaw在啟動過程中檢測到重復(fù)的feishu插件ID并導(dǎo)致沖突的問題,通過查找和刪除全局插件文件并調(diào)整配置文件,成功解決了這個問題,感興趣的朋友跟隨小編一起看看2026-03-17
在Ubuntu上快速部署OpenClaw并接入飛書的完整過程
OpenClaw是一個可擴展的 AI 助手運行框架,核心目標(biāo)是讓助手真正“能做事”,這篇文章主要介紹了在Ubuntu上快速部署OpenClaw并接入飛書的完整過程,文中通過圖文介紹的非常詳2026-03-13
OpenClaw 從零配置指南并接入飛書 + 常用命令 + 原理全解析
本文介紹了如何從零配置OpenClaw并接入飛書,包括安裝、配置、權(quán)限設(shè)置、模型切換、技能管理等步驟,以及常用命令和配置文件說明,感興趣的朋友跟隨小編一起看看吧2026-03-12
2026年OpenClaw(前身為Moltbot)憑借輕量化部署、強大的AI任務(wù)執(zhí)行能力與靈活的生態(tài)集成特性,成為企業(yè)智能化辦公的核心工具,這篇文章主要介紹了OpenClaw連接飛書插件安裝、2026-03-10











