【OpenClaw】解决 OpenClaw 飞书插件冲突导致的配对失败问题

排查并修复 OpenClaw 飞书插件冲突引发的配对失效

问题表现

开发者在使用 OpenClaw 为飞书机器人执行标准配对指令时：

openclaw pairing approve feishu EWNDU58A

系统并未成功响应，而是返回了以下错误：

[openclaw] Failed to start CLI: Error: No pending pairing request found for code: EWNDU58A

排查网关启动日志时，发现了关键的系统提示：

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

这表明配对码有效但请求无法被定位，根源指向插件加载异常。

核心原因

问题根因是 OpenClaw 实例中存在两个相同标识（ID）的飞书插件，引发了加载冲突：

1. 核心内置插件：自 2026.2 版本起，飞书插件已成为 OpenClaw 的标准组件。
2. 用户侧重复安装：在用户扩展目录中，残留了一个手动安装或历史遗留的插件副本。

系统同时加载二者，触发 `duplicate plugin id` 警告。此冲突直接导致插件内部状态机紊乱：配对批准请求可能记录在插件A，而实际处理飞书数据流的是插件B。两者状态不同步，最终引发了“找不到待处理请求”的误导性报错。

修复步骤

1. 清理冗余插件副本

首要操作是移除用户目录下的冲突副本。通过文件管理器定位至 OpenClaw 扩展目录：

C:\Users\sheng\.openclaw\extensions\

删除其中的 `feishu` 文件夹即可。此操作强制系统依赖唯一的内置插件运行。

2. 重启网关服务

删除文件后，必须重启服务使配置生效。在终端执行：

openclaw gateway restart

重启后，请确认启动日志中不再出现插件重复的警告信息。

3. 重新执行配对流程

鉴于原有配对状态可能已损坏，需要重新初始化整个流程。

在飞书侧重新触发机器人配对，获取全新的配对验证码（例如 `NEWCODE123`）。

随后使用新验证码执行批准指令：

openclaw pairing approve feishu NEWCODE123

4. 验证问题解决

• 日志验证：确认网关启动日志无任何插件加载警告。
• 功能测试：在飞书向机器人发送测试消息，验证其能否正常响应，排除“未授权”或“未配置”类的权限错误。

长期预防策略

为避免未来再次发生同类冲突，建议配置插件加载白名单以实施精确控制。

打开 OpenClaw 主配置文件（路径通常为 `~/.openclaw/config.yaml` 或 `C:\Users\sheng\.openclaw\config.yaml`），在 `plugins` 配置节中添加允许清单：

plugins:
  allow:
    - feishu

该配置将指示 OpenClaw 仅加载白名单内声明的插件。即使 `extensions` 目录下存在其他副本，系统也会主动忽略，从源头杜绝重复加载的可能性。

结论

OpenClaw 内置插件与外部副本并存导致的标识冲突，是引发配对失败等状态不一致问题的典型原因。彻底解决方案明确：移除冗余副本、重启服务、重新建立配对。同时，配置插件白名单是一项值得实施的长效治理策略。

此排查路径适用于多数插件冲突场景。若在 OpenClaw 部署中遇到其他复杂情况，可依据类似逻辑进行分析。

来源：互联网