OpenClaw飞书官方插件配置指南
OpenClaw 飞书官方插件配置指南:官方的终于来了
OpenClaw 早就内置了飞书通道,我之前一直用的是这个——说白了就是 OpenClaw 社区自己搞的接入方案。能跑,但总感觉差点意思。
直到前两天看到飞书官方宣布推出官方插件,我才明白:原来正主终于出手了。

这玩意儿和 OpenClaw 内置的飞书通道有什么不一样?简单说:
- 内置通道: OpenClaw 自己折腾的,能连,但权限有限
- 官方插件: 飞书官方出的,权限全、更新快、正儿八经的支持
说白了,就是“民间版”终于变成“正式版”。
OpenClaw 内置 vs 官方插件对比
|
|
|
|
|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
这玩意儿能干啥?
简单说:你说一句话,它就能以你的身份去飞书里干活。
比如:
-
“帮我把上周的会议纪要整理一下”——它能直接读你的文档 -
“看看我明天下午有没有空”——它能查你的日历 -
“群里刚才说了啥?”——它能翻聊天记录 -
“帮我创建一个多维表格,记录项目进度”——它能直接建表
以前这些事儿,你得手动打开飞书、找到文件、复制粘贴给 AI。现在?一句话的事儿。
说白了,就是让你的 AI 助手从“只能聊天”变成“能干活”。
安装前先说清楚:有风险
这插件能读写你的消息、文档、日历、联系人。AI 能读到的东西,理论上就有泄露的可能。
官方的建议很实在:先用个人账号玩起来,等安全隔离能力成熟了,再接入真实工作环境。
我自己的做法是:创建了一个专门的飞书机器人,不接公司群,只在自己建的小群里测试。这样就算翻车了,也不会影响正经工作。
(别问我怎么知道要这样做的,问就是踩过坑。)
开始安装
第一步:安装 OpenClaw
如果你还没装 OpenClaw,先看这篇文章:OpenClaw 0基础保姆级部署与配置指南
第二步:装飞书官方插件
这一步比我想象的简单多了。就一行命令:
1 npx -y @larksuite/openclaw-lark install
执行后会问你:新建机器人还是关联已有机器人。

如果你之前没创建过飞书应用,选“新建”,然后用飞书扫码就能一键创建。整个过程大概 3 分钟,比我预期的快很多。

如果你已经有飞书应用了,选“关联已有机器人”,输入 App ID 和 App Secret 就行。

第三步:授权
机器人创建好后,在飞书里找到它,发一条消息。
这时候它会提示你授权。强烈建议先发 /feishu auth 完成批量授权,不然后面用着用着就会遇到“权限不足”的问题。
(别问我怎么知道的,问就是又踩过坑。)
授权完成后,发个 /feishu start 测试一下。如果返回版本号,就说明装成功了。

实际体验:能用,但偶尔会犯傻
装好后我测了几个场景:
场景一:读文档
我说“帮我看看《项目计划》这个文档里写了什么”。
它直接就读出来了,不用我上传文件,也不用复制粘贴。这个体验真的很爽。
场景二:查日历
我说“明天下午有没有空?”
它查了一下,告诉我明天下午 2 点有个会,4 点以后有空。比我自己打开日历看快多了。
场景三:群聊记录
我说“群里今天讨论了什么?”
它翻了翻记录,给我总结了一下。这个功能对经常错过群消息的人很友好。
场景四:翻车现场
有一次我让它“帮我把这个文档发到群里”,结果它告诉我:微信接口不支持直接发文件。
我愣了一下,才反应过来——我是在飞书里啊!不是微信!
后来发现是它理解错了,以为我要发到微信。AI 偶尔会犯这种“聪明反被聪明误”的错误,得盯着点。
高级配置:让体验更好
开启流式输出
默认情况下,AI 会等全部想完再回复你。开启流式输出后,它会边想边说,体验更流畅:
1 openclaw config set channels.feishu.streaming true

群聊回复模式
默认是“只有 @机器人才回复”。这个设置比较安全,避免机器人在群里刷屏。
如果你想让它更活跃一点,可以改成“不用 @ 也回复”——但千万别在大群里这么干,会被同事打死的。
常见问题
权限不足怎么办?
去飞书开放平台,找到你的应用,在“权限管理”里批量导入权限。官方文档里有完整的权限列表,复制粘贴就行。
Windows 上扫码失败?
换个终端试试,比如 Cmder。Windows 自带的终端有时候分辨率有问题,二维码扫不出来。
升级后出问题?
运行诊断命令:
1 npx @larksuite/openclaw-lark doctor
如果诊断出问题,可以尝试自动修复:
1 npx @larksuite/openclaw-lark doctor --fix
总结
飞书官方插件 = 让 OpenClaw 从“聊天机器人”变成“数字员工”。
优点:
-
安装简单,一行命令搞定 -
能直接读写飞书里的数据,不用复制粘贴 -
支持消息、文档、日历、多维表格等多种场景
缺点:
-
有数据安全风险,建议先用个人账号测试 -
AI 偶尔会犯傻,重要操作得盯着 -
部分功能受飞书平台限制
如果你:
-
已经在用 OpenClaw -
日常工作离不开飞书 -
想让 AI 真正帮你干活而不是只会聊天
那这个插件值得一试。
PS: 官方文档说插件还在快速迭代,每天都会变得更好用。有问题可以去反馈群里问问,老玩家带新玩家,氛围还不错。
最新版本和更新日志可以在官方文档里看:OpenClaw 飞书官方插件使用指南
夜雨聆风