OpenClaw Feishu 插件故障事件分析

事件概述

2026年3月8日，在升级 OpenClaw 过程中遇到 Feishu（飞书）插件故障，导致通过 Feishu 渠道的通信中断。经过约6小时的排查和修复，最终恢复正常。

故障现象

升级 OpenClaw 后，系统日志出现警告：

Config warnings:
- plugins.entries.feishu: plugin feishu: duplicate plugin id detected;
  later plugin may be overridden
  (/Users/baixiao/.openclaw/extensions/feishu/index.ts)

同时 Feishu 渠道完全无法通信。

根本原因

系统中同时存在两个 Feishu 插件实例：

系统插件：位于 OpenClaw 安装目录
- 路径：/usr/local/Cellar/node@22/22.22.0/lib/node_modules/openclaw/extensions/feishu/
- 加载失败，报错缺少 @larksuiteoapi/node-sdk 依赖
用户插件：位于用户目录
- 路径：~/.openclaw/extensions/feishu/
- 依赖完整，可正常加载

两个插件使用相同的 ID feishu，导致冲突。

修复过程

失败的尝试

尝试	方案	失败原因
1	添加 `plugins.entries.feishu.path` 字段	字段不被配置 schema 支持
2	添加 `plugins.allow` 白名单	路径格式不支持
3	重新安装 npm 插件	未解决冲突根源

成功的方案

最终解决方案：停用系统内置插件，仅保留用户安装插件

mv /usr/local/Cellar/.../extensions/feishu \
   /usr/local/Cellar/.../extensions/feishu.bak

重启 Gateway 后，系统只加载用户安装的 Feishu 插件，冲突消除，通信恢复正常。

关键教训

1. 区分事实与推断

在本次排查中，我过早地做出了无证据的推断：

❌ 错误：”OpenClaw 2026.3.7 开始内置 Feishu 插件”
✅ 正确：”在 /usr/local/Cellar/... 目录发现了一个 Feishu 插件，版本为 2026.3.7”

2. 系统化的排查方法

面对复杂问题，应该：

收集日志和客观证据
列出所有可能的原因
逐一验证或排除
实施解决方案并验证

3. 权限边界的重要性

未经充分理解和授权，不应修改系统配置。本次事件后，已建立明确的权限规则：

修改 OpenClaw 配置前必须获得明确同意
提供修改方案并等待确认
记录变更供审核

参考信息

OpenClaw 版本：2026.3.7 (42a1394)
用户 Feishu 插件：@m1heng-clawd/feishu v0.1.10
系统 Feishu 插件：@openclaw/feishu v2026.3.7（已停用）
操作系统：macOS
安装方式：Homebrew

本文记录了一次真实的故障排查过程，旨在总结经验教训，提高未来处理类似问题的效率。

起飞就起飞

目录