大家好，我是石头，一个有10多年java开发、项目管理经验的宝妈，专注于分享学习AI过程与经验。

昨日为 Mac 端的 OpenClaw（小龙虾）更换飞书官方插件，原社区版插件存在权限适配问题，即便安装新版官方插件，启动时仍会默认加载老插件，后续使用中遇到了一系列问题，经调试后完美解决，同时完成了对小龙虾的指令调教，新版插件的体验也远超社区版。现将全程踩坑修复、插件部署实操、小龙虾调教心得整理如下，附 Docker 和 Mac 端完整安装步骤。

在完成新版插件初步安装后，今早在飞书群内@小龙虾触发指令时，出现了机器人莫名重启的问题。多次与小龙虾对话排查后得知，当前使用的MiniMax M2.5 模型存在“过度主动”的特性，会在无用户指令的情况下，自行执行openclaw gateway start这类系统命令，而该命令会干扰正在运行的 Gateway 服务，这也是群聊触发重启的核心原因。发现该自动重启问题后，我在memory.md 文件中写入硬性规则：禁止自动执行 openclaw 开头的系统命令，需等待用户确认，从配置层面规避此类问题再次发生。

后续发现，脱离飞书群聊、仅在私聊界面与小龙虾互动时，不会出现重启问题；同时主 session 弹出超会话提示，新建 session 后该问题即恢复正常。为稳妥起见，后续便采用飞书私聊的方式与小龙虾交互，私聊过程中，小龙虾提示多维表格操作仍需授权部分权限，按提示完成contact:user.basic_profile:readonly权限申请后，即可正常使用相关功能。

曾给小龙虾设置每周一早自动汇报收支数据的定时任务，实际使用中发现，小龙虾对 “一周” 的时间范围界定存在偏差，经明确告知其 “一周为自然周完整 7 天，如 3 月 16 日（周一）-3 月 22 日（周日）” 后，小龙虾成功理解时间范围。调教完成后，让其在飞书群内补发了该时间段的收支汇报，同时引导其学习专业报表的呈现形式，最终小龙虾输出的汇报包含收支趋势、分类占比、数据汇总，还附带现金流健康分析和增收建议，呈现效果远超预期。

对比此前使用的 OpenClaw 社区版飞书插件，新版官方插件的体验提升显著：社区版插件频繁出现权限不足的提示，且无明确的授权引导；新版插件会自动分析操作所需权限，清晰标注待授权项并分步引导操作，部署时一条命令即可完成核心配置，整体操作丝滑流畅。

附：Docker 版 OpenClaw 安装新版飞书插件实操步骤

1. 核心安装命令

docker exec -it 容器名 npx -y @larksuite/openclaw-lark install 

执行后按提示确认现有机器人配置，完成插件注册，最终提示需重启 Gateway 加载插件。

验证安装成功，在飞书中发送/feishu start,如果出现版本号就代表成功了。

2. 安装失败修复（旧插件未禁用导致）

若执行启动命令/feishu start提示启动失败，且小龙虾提示 “检测到旧版插件未禁用”，需执行以下命令禁用旧插件，因是 Docker 环境，命令需做适配：

docker exec -it 容器名 openclaw config set plugins.entries.feishu.enabled false --json docker compose restart

重启容器后，再次执行/feishu start，即可成功启动新版飞书插件（版本 v2026.3.17）。

3. 插件升级命令

dockerexec-it 容器 npx -y @larksuite/openclaw-lark update

4. 让小龙虾快速掌握插件能力

直接在对话界面发送指令：学习一下我安装的新飞书插件，列出有哪些能力，小龙虾会自动学习并总结插件核心功能，同时标注使用注意事项。

5. 飞书插件流式输出配置

开启流式输出后，可在卡片上显示更多内容，执行以下命令即可配置（Docker 环境通用）：

# 开启流式输出docker exec -it 容器 openclaw config set channels.feishu.streaming true# 开启耗时展示openclaw config set channels.feishu.footer.elapsed truer: only_fans

# 开启状态展示openclaw config set channels.feishu.footer.status true

附：Mac 版 OpenClaw 安装新版飞书插件实操步骤

Mac 端安装需先清理老插件相关配置，避免启动时加载旧版本，步骤如下：

1. 清理老插件配置

编辑 OpenClaw 配置文件：

nano  ~/.openclaw/openclaw.json

找到"entries"节点，删除其中的"feishu": { "enabled": true }配置项；

• 找到"installs"节点，删除该节点下的所有内容；保存并退出配置文件。

2. 执行官方安装命令。

npx -y @larksuite/openclaw-lark install

3. 启动异常修复

执行启动命令后若出现两个警示：

⚠️ 飞书 OpenClaw 插件已启动 v2026.3.18（存在警告）

⚠️ 工具 Profile 当前为 messaging，飞书工具可能无法加载。请检查配置是否正确。

只需修复第二个配置问题即可，重新编辑配置文件：

nano ~/.openclaw/openclaw.json

找到"tools"节点，将"profile"值修改为"full"，即：

"tools":{   "profile":"full"}

4. 验证启动结果

保存配置后重启 OpenClaw，执行指令/feishu start，提示飞书OpenClaw插件已启动v2026.3.18即表示安装成功。

5. 插件能力学习

与 Docker 版一致，直接发送指令：学习一下我安装的新飞书插件，列出有哪些能力，即可让小龙虾完成插件能力学习。

小龙虾调教小技巧

• 避免使用 MiniMax M2.5 模型，其过度主动执行系统命令的特性，易导致服务异常，可在 memory.md 中写入规则限制系统命令自动执行；
• 若出现机器人重启、会话异常，可尝试新建 session，大概率能解决问题；
• 设置定时 / 周期性任务时，需明确界定时间范围、数据口径等细节，越具体越不易出错；
• 对输出结果有格式要求时，可直接给出示例，引导小龙虾按规范呈现；
• 新插件安装后，务必发送指令让小龙虾主动学习插件能力，才能充分发挥其功能。

如果这篇教程对你有帮助，随手点个点赞 /在看，想第一时间收到更多OpenClaw安全使用技巧，就给我加个星标吧～