飞书(Feishu)
约 2236 字大约 7 分钟
2026-03-02
概述
飞书(Feishu/Lark)是 OpenClaw 支持的重要 IM 渠道之一。相比于 Telegram 等国外平台,飞书是国内的平台,有中文的界面、文档和客服,更容易上手。飞书的开放能力更强,能获取更多工作中必要的上下文,是国内接入 OpenClaw 的最佳选择。
通过飞书官方插件,OpenClaw 可以:
- 以你的身份完成工作(回消息、写文档、生成多维表格等)
- 获取飞书内的海量上下文(消息、文档、会议纪要、多维表格、日程、任务等)
- 支持消息流式生成
前置准备
版本要求
- Linux/MacOS:openclaw 2026.2.26 及以上
- Windows:openclaw 2026.3.2 及以上
查看版本:
openclaw -v如低于要求版本,执行升级:
npm install -g openclaw@latest免安装方案
使用以下平台安装的 OpenClaw 已自带飞书插件,无需阅读后续的安装步骤:
安装步骤
1. 安装飞书插件
执行以下命令安装飞书官方插件:
npx -y https://sf3-cn.feishucdn.com/obj/open-platform-opendoc/8ab6e7a04c17db1becfcbda8ca35f091_1rCCFRWlRV.tgz install提示
如果执行出错,可尝试在命令前增加 sudo 重新执行。
执行过程中通过飞书客户端扫描二维码,可以一键创建飞书机器人。系统将自动申请所需的权限、安全设置并提交发布。
Windows 用户
如果 Windows 设备中扫码无法成功,可能是因为终端的分辨率问题导致,建议更换终端,使用:Cmder
2. 验证安装
创建好后,在飞书中打开机器人即可使用:
- 在飞书中向机器人发送任意消息,即可开始对话
- 确认是否安装成功,可发送:
/feishu start- 如果返回了版本号信息,则代表安装成功
- 让龙虾学习新技能:发送「学习一下我安装的新飞书插件,列出有哪些能力」
- 如果想要让小龙虾可以读写你的飞书数据(如云文档、日历、消息、多维表格),可以输入
/feishu auth来完成批量授权
飞书插件能力
| 类别 | 能力 |
|---|---|
| 💬 消息 | 消息读取(群聊/单聊历史、话题回复)、消息发送、消息回复、消息搜索、图片/文件下载 |
| 📄 文档 | 创建云文档、更新云文档、读取云文档内容 |
| 📊 多维表格 | 创建/管理多维表格,数据表、字段、记录(增删改查、批量操作、高级筛选)、视图 |
| 📅 日历日程 | 日历管理、日程管理(创建/查询/修改/删除/搜索)、参会人管理、忙闲查询 |
| ✅ 任务 | 任务管理(创建/查询/更新/完成)、清单管理、子任务、评论 |
使用配置
流式输出配置
切换到流式输出(推荐),可运行指令:
openclaw config set channels.feishu.streaming true不用流式输出:
openclaw config set channels.feishu.streaming false流式输出卡片支持显示更多内容:
openclaw config set channels.feishu.footer.elapsed true # 开启耗时
openclaw config set channels.feishu.footer.status true # 开启状态展示多任务并行独立上下文
机器人可在话题群/消息群话题模式中,针对每个话题拥有独立上下文以及多任务并行。
开启:
openclaw config set channels.feishu.threadSession true关闭:
openclaw config set channels.feishu.threadSession false群内回复方式配置
目前插件默认方式:可被拉进群,只有 @机器人才可回复。
模式 1:只有 @机器人 才回复(最常用)
openclaw config set channels.feishu.requireMention true --json
# 重启生效
sh /workspace/projects/scripts/restart.sh模式 2:不用 @,所有消息都回复
需要额外在开发者后台申请权限:im:message.group_msg
openclaw config set channels.feishu.requireMention false --json
# 重启生效
sh /workspace/projects/scripts/restart.sh注意
这个模式在大群里容易刷屏,谨慎使用!
模式 3:只有指定群 @机器人 才回复(高级)
第一步:获取群 ID 让机器人加入群后,发送任意消息,然后在日志里找群 ID,或者让机器人回复群 ID。
第二步:配置特定群规则
# 先设置默认所有群都不需要 @
openclaw config set channels.feishu.requireMention open --json
# 然后给特定群设置需要 @(群ID替换为真实的)
openclaw config set channels.feishu.groups.oc_xxxxxxxx.requireMention true --json
# 重启生效
sh /workspace/projects/scripts/restart.sh诊断与修复
诊断命令
在与 AI 的对话中发送以下命令:
| 命令 | 说明 |
|---|---|
/feishu start | 确认是否安装成功 |
/feishu doctor | 检查配置是否正常 |
/feishu auth | 批量完成用户授权 |
手动诊断
如果对话中命令不行,则运行指令:
npx https://sf3-cn.feishucdn.com/obj/open-platform-opendoc/8ab6e7a04c17db1becfcbda8ca35f091_1rCCFRWlRV.tgz doctor自动修复
运行以下命令尝试自动修复:
npx https://sf3-cn.feishucdn.com/obj/open-platform-opendoc/8ab6e7a04c17db1becfcbda8ca35f091_1rCCFRWlRV.tgz doctor --fix查看版本信息
npx https://sf3-cn.feishucdn.com/obj/open-platform-opendoc/8ab6e7a04c17db1becfcbda8ca35f091_1rCCFRWlRV.tgz info查看详细配置信息:
npx https://sf3-cn.feishucdn.com/obj/open-platform-opendoc/8ab6e7a04c17db1becfcbda8ca35f091_1rCCFRWlRV.tgz info --all权限申请
如果使用插件时出现权限不足,需要申请所需权限:
步骤 1:导入权限
- 打开 飞书开放平台
- 选择「开发配置 > 权限管理」
- 单击「批量导入/导出权限」按钮
- 在「导入」页签中,将如下权限替换原有示例
{
"scopes": {
"tenant": [
"contact:contact.base:readonly",
"docx:document:readonly",
"im:chat:read",
"im:chat:update",
"im:message.group_at_msg:readonly",
"im:message.p2p_msg:readonly",
"im:message.pins:read",
"im:message.pins:write_only",
"im:message.reactions:read",
"im:message.reactions:write_only",
"im:message:readonly",
"im:message:recall",
"im:message:send_as_bot",
"im:message:send_multi_users",
"im:message:send_sys_msg",
"im:message:update",
"im:resource",
"application:application:self_manage",
"cardkit:card:write",
"cardkit:card:read"
],
"user": [
"contact:user.employee_id:readonly",
"offline_access",
"base:app:copy",
"base:field:create",
"base:field:delete",
"base:field:read",
"base:field:update",
"base:record:create",
"base:record:delete",
"base:record:retrieve",
"base:record:update",
"base:table:create",
"base:table:delete",
"base:table:read",
"base:table:update",
"base:view:read",
"base:view:write_only",
"base:app:create",
"base:app:update",
"base:app:read",
"sheets:spreadsheet.meta:read",
"sheets:spreadsheet:read",
"sheets:spreadsheet:create",
"sheets:spreadsheet:write_only",
"docs:document:export",
"docs:document.media:upload",
"board:whiteboard:node:create",
"board:whiteboard:node:read",
"calendar:calendar:read",
"calendar:calendar.event:create",
"calendar:calendar.event:delete",
"calendar:calendar.event:read",
"calendar:calendar.event:reply",
"calendar:calendar.event:update",
"calendar:calendar.free_busy:read",
"contact:user:search",
"docs:document.comment:create",
"docs:document.comment:read",
"docs:document.comment:update",
"docs:document.media:download",
"docs:document:copy",
"docx:document:create",
"docx:document:readonly",
"docx:document:write_only",
"drive:drive.metadata:readonly",
"drive:file:download",
"drive:file:upload",
"im:chat.members:read",
"im:message",
"im:message.group_msg:get_as_user",
"im:message.p2p_msg:get_as_user",
"search:docs:read",
"search:message",
"space:document:delete",
"space:document:move",
"space:document:retrieve",
"task:comment:read",
"task:comment:write",
"task:task:read",
"task:task:write",
"task:task:writeonly",
"task:tasklist:read",
"task:tasklist:write",
"wiki:node:copy",
"wiki:node:create",
"wiki:node:move",
"wiki:node:read",
"wiki:node:retrieve",
"wiki:space:read",
"wiki:space:retrieve",
"wiki:space:write_only"
]
}
}- 确认权限无误后,单击「申请开通」
步骤 2:发布应用
- 单击顶部的「创建版本」按钮
- 按需配置应用版本号、默认能力及更新说明
- 单击「保存」创建版本
- 单击「确认发布」完成应用发布
插件更新
插件能力实时更新,欢迎更新到插件最新版本体验最新能力。
在「终端」中运行:
npx -y https://sf3-cn.feishucdn.com/obj/open-platform-opendoc/8ab6e7a04c17db1becfcbda8ca35f091_1rCCFRWlRV.tgz update提示
如果执行出错,可尝试在命令前增加 sudo 重新执行。
多机器人配置
方式一:快捷创建
一键创建新的 OpenClaw 机器人:立即创建
方式二:手动配置
- 告诉 AI 你想创建一个怎样的新 Agent,以及这个 Agent 关联的飞书账号是什么
- 将操作指南发给 OpenClaw 请他自己完成对应配置
安全与风险提示
核心风险
这个插件通过飞书接口连接了你的工作数据——消息、文档、日程、联系人,AI 能读到的东西理论上就有泄露的可能。
强烈建议
- 现阶段切勿使用公司/企业飞书账号接入! 请务必优先使用个人账号进行体验和测试
- 对于涉及发送、修改、写入等重要操作,请务必做到「先预览,再确认」
- 切勿让 AI 处于完全脱离人工干预的「全自动驾驶」状态
操作风险
- AI 并不完美,可能存在「幻觉」
- 部分操作不可逆转(例如 AI 代发的飞书消息是以您的名义发出的)
常见问题
Q: 插件安装完毕运行后,报 cannot find module xxx
原因:系统没有安装插件的依赖(可能是安装被中断或权限问题)
解决方法:进入插件安装目录,运行 npm install
Q: Coze 上安装失败
依次执行以下命令:
export NPM_CONFIG_REGISTRY=https://registry.npmmirror.com
npx -y https://sf3-cn.feishucdn.com/obj/open-platform-opendoc/8ab6e7a04c17db1becfcbda8ca35f091_1rCCFRWlRV.tgz install检查老插件的配置,如果为「true」需要改成「false」。
Q: 升级到 OpenClaw 3.2 版本后无法正常调用工具
原因:这个版本默认把新 agent 的工具权限关闭
修复方式:在 openclaw.json 加上这段内容:
{
"tools": {
"profile": "full",
"sessions": {
"visibility": "all"
}
}
}