夜雨聆风
OpenClaw 飞书官方插件安装指南|3 分钟快速接入
导读：OpenClaw 已安装完成？本文只讲飞书插件安装，跳过所有 OpenClaw 基础配置，3 分钟让你的 AI 助手接入飞书！
🦞 飞书官方插件能做什么？
飞书官方插件让 OpenClaw 能够以你的身份直接操作飞书，无需反复复制粘贴。
支持的核心能力
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
典型使用场景
⚠️ 重要提示：以用户身份发消息需在飞书开放平台开通机器人
im:message.send_as_user权限，部分企业（如字节）不支持此操作。
⚠️ 安全与风险提示（使用前必读）
🔴 核心风险
该插件通过飞书接口连接了你的工作数据——消息、文档、日历、联系人，AI 能读到的东西理论上就有泄露的可能。
🔴 强烈建议：
📌 其他操作风险
💡 使用建议
🦞 先拿个人账号安全地”玩”起来，等后续安全隔离能力更成熟了，再考虑接入真实工作环境。
🚀 从 0 安装飞书插件
💡 前提条件：确保 OpenClaw 已安装并配置完成。如果还没安装 OpenClaw，请先参考 官方安装指南[1]。
步骤一：执行安装命令
在命令行终端中，执行以下安装指令：
npx -y @larksuite/openclaw-lark install💡 提示：若执行命令行出错，可在命令行前增加
sudo重新执行。
步骤二：选择机器人配置方式
执行过程中，可选择：
选项 A：新建机器人（推荐新手）
💡 Windows 用户注意：如果 Windows 设备中无法扫码成功，可能是因为终端的分辨率问题，建议更换终端使用 Cmder[2]。
选项 B：关联已有机器人
⚠️ 注意：若提示无效的 App ID 或 App Secret，可手动输入正确的应用凭证信息。
步骤三：完成授权
创建完成后，点击 打开机器人，在飞书中向机器人发送任意消息，即可开始对话。
步骤四：快速授权（可选）
若希望快速完成用户授权，便于后续 OpenClaw 通过你的身份完成消息、文档、多维表格、日历等任务，可以在飞书对话中发送：
/feishu auth步骤五：让 AI 学习新技能
为了让 OpenClaw 能学会这些新技能并正确使用，建议在飞书对话中发送：
学习一下我安装的新飞书插件，列出有哪些能力步骤六：验证安装
在飞书对话中发送：
/feishu start若返回了版本号信息，则代表安装成功！🎉
🔧 高级配置指令
1. 切换到流式输出
流式输出可以让回复内容逐步显示，体验更流畅。
开启流式输出：
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
2. 设置多任务并行及独立上下文
机器人可在话题群/消息群话题模式中，针对每个话题拥有独立上下文以及多任务并行。
开启：
openclaw config set channels.feishu.threadSession true关闭：
openclaw config set channels.feishu.threadSession false3. 修改群内回复方式
模式 1：仅响应主人@消息（推荐，3.17+ 版本默认）
机器人仅响应应用所有者（主人）@机器人的消息，不响应其他人。
配置方法：
{"channels":{"feishu":{"enabled":true,"appId":"cli_你的 AppID","appSecret":"你的 AppSecret","requireMention":true,"groupPolicy":"allowlist","groupAllowFrom":["ou_XXXX"],"groups":{"*":{"enabled":true}}}}}
将 groupPolicy 设置为 "allowlist"（白名单），并通过 groupAllowFrom 指定允许触发机器人的用户（你的 openid）。
模式 2：仅@才回复，可响应任何人
配置方法：
# 设置需要 @ 才回复openclaw config set channels.feishu.requireMention true--json# 重启生效sh /workspace/projects/scripts/restart.sh
完整配置：
{"channels":{"feishu":{"enabled":true,"appId":"cli_你的 AppID","appSecret":"你的 AppSecret","requireMention":true,"groupPolicy":"open"}}}
模式 3：不用@，所有消息都回复
⚠️ 注意：这个模式在大群里容易刷屏，谨慎使用！
需要额外在开发者后台申请应用身份权限：获取群组中所有消息（敏感权限）im:message.group_msg。
配置方法：
# 设置不需要 @ 也回复openclaw config set channels.feishu.requireMention false--json# 重启生效sh /workspace/projects/scripts/restart.sh
模式 4：特定群@才回复（高级）
效果：
第一步：获取群 ID
方式 1：让机器人加入群后发送消息，在日志里找群 ID
方式 2：群成员点击右上角群菜单 → 群设置页面，查看群 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
⬆️ 升级飞书插件版本
飞书团队正在快速优化迭代官方插件，建议保持最新版本。
检查版本要求
运行以下命令查看已安装的 OpenClaw 版本：
openclaw -v版本要求：
若低于该版本，先升级 OpenClaw：
npm install -g openclaw升级插件
在终端中运行：
npx -y @larksuite/openclaw-lark update💡 提示：若执行该命令行出错，可在命令行前增加
sudo重新执行。
🔍 常用诊断命令
可以在与 OpenClaw 的对话中发送以下命令：
|
|
|
/feishu start |
|
/feishu doctor |
|
/feishu auth |
|
问题排查与修复
查看问题并自主修复：
npx @larksuite/openclaw-lark doctor尝试自动修复：
npx @larksuite/openclaw-lark doctor --fix查看版本信息（反馈问题时带上）：
npx @larksuite/openclaw-lark info查看详细配置信息：
npx @larksuite/openclaw-lark 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","contact:user.basic_profile:readonly"],"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:contact.base:readonly","contact:user.base:readonly","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:chat:read","im:message","im:message.group_msg:get_as_user","im:message.p2p_msg:get_as_user","im:message:readonly","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","contact:user.basic_profile:readonly"]}}
问题 2：插件安装完毕运行后，报 cannot find module xxx
原因：系统没有安装插件的依赖（可能是安装被中断或权限问题）
解决方法：进入插件安装目录，运行 npm install。
问题 3：Coze 上安装失败
解决方法：
# 设置国内镜像export NPM_CONFIG_REGISTRY=https://registry.npmmirror.com# 重新安装npx -y @larksuite/openclaw-lark install
true，需要改成 false问题 4：升级到 OpenClaw 3.2 版本后无法正常调用工具
原因：这个 OpenClaw 版本默认把新 agent 的工具权限关闭
解决方法：在 openclaw.json 找到并修改为：
{"tools":{"profile":"full","sessions":{"visibility":"all"}}}
📊 飞书官方插件 vs 社区插件
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
🎉 总结
恭喜你完成飞书官方插件的安装！
关键步骤回顾
|
|
|
|
|
|
|
npx -y @larksuite/openclaw-lark install |
|
|
|
|
|
|
|
|
|
|
|
/feishu auth |
|
|
|
|
|
|
|
/feishu start |
下一步
遇到问题？在评论区留言或加入 OpenClaw 社区讨论！
觉得有用？欢迎分享给更多小伙伴！