OpenClaw Feishu 插件故障事件分析

事件概述

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

故障现象

通过 OpenClaw 来自我升级:

升级 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 插件实例：

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

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

修复过程

失败的尝试

成功的方案

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

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. 系统化的排查方法

面对复杂问题，应该：

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

3. 权限边界的重要性

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

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

参考信息

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

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

今日小课堂

今日小幽默