OpenClaw解决飞书 duplicate plugin id detected 问题

1.查看日志

飞书运行过程中产生警告：

bash 复制代码

$ openclaw gateway --port 18789 --verbose
Config warnings:\n- plugins.entries.feishu: plugin feishu: duplicate plugin id detected; later plugin may be overridden (/home/ubuntu/.openclaw/extensions/feishu/index.ts)

🦞 OpenClaw 2026.3.13 (61d171a) --- Gateway online---please keep hands, feet, and appendages inside the shell at all times.

│
◇  Config warnings ─────────────────────────────────────────────────────────────────────────╮
│                                                                                           │
│  - plugins.entries.feishu: plugin feishu: duplicate plugin id detected; later plugin may  │
│    be overridden (/home/ubuntu/.openclaw/extensions/feishu/index.ts)                      │
│                                                                                           │
├───────────────────────────────────────────────────────────────────────────────────────────╯
09:54:04 Config warnings:\n- plugins.entries.feishu: plugin feishu: duplicate plugin id detected; later plugin may be overridden (/home/ubuntu/.openclaw/extensions/feishu/index.ts)
09:54:04 [plugins] plugins.allow is empty; discovered non-bundled plugins may auto-load: feishu (/home/ubuntu/.openclaw/extensions/feishu/index.ts). Set plugins.allow to explicit trusted ids.
09:54:04 Registered plugin command: /pair (plugin: device-pair)
...

2. 分析日志：

部分	含义
plugins.entries.feishu	飞书（Feishu）插件的入口配置
plugin feishu: duplicate plugin id detected	检测到重复的插件 ID "feishu"
later plugin may be overridden	后加载的插件可能会被覆盖
/home/ubuntu/.openclaw/extensions/feishu/index.ts	问题插件的文件路径

核心问题：系统发现了两个 ID 相同的 "feishu" 插件，导致冲突，后加载的那个会被覆盖。

常见原因：

插件被重复安装到不同目录
手动复制插件文件导致重复
插件更新后旧版本未清理

查找系统中安装的飞书插件：

bash 复制代码

$ find / -name "*feishu*" -type d 2>/dev/null
/home/ubuntu/.nvm/versions/node/v24.14.0/lib/node_modules/openclaw/extensions/feishu
/home/ubuntu/.nvm/versions/node/v24.14.0/lib/node_modules/openclaw/extensions/feishu/skills/feishu-doc
/home/ubuntu/.nvm/versions/node/v24.14.0/lib/node_modules/openclaw/extensions/feishu/skills/feishu-wiki
/home/ubuntu/.nvm/versions/node/v24.14.0/lib/node_modules/openclaw/extensions/feishu/skills/feishu-perm
/home/ubuntu/.nvm/versions/node/v24.14.0/lib/node_modules/openclaw/extensions/feishu/skills/feishu-drive
/home/ubuntu/.openclaw/extensions/feishu
/home/ubuntu/.openclaw/extensions/feishu/skills/feishu-doc
/home/ubuntu/.openclaw/extensions/feishu/skills/feishu-wiki
/home/ubuntu/.openclaw/extensions/feishu/skills/feishu-perm
/home/ubuntu/.openclaw/extensions/feishu/skills/feishu-drive

3. 查看使用的飞书插件

3.1 查看插件列表

bash 复制代码

$ openclaw plugins list | grep feishu
Config warnings:\n- plugins.entries.feishu: plugin feishu: duplicate plugin id detected; later plugin may be overridden (/home/ubuntu/.openclaw/extensions/feishu/index.ts)
[plugins] plugins.allow is empty; discovered non-bundled plugins may auto-load: feishu (/home/ubuntu/.openclaw/extensions/feishu/index.ts). Set plugins.allow to explicit trusted ids.
[plugins] feishu_doc: Registered feishu_doc, feishu_app_scopes
[plugins] feishu_chat: Registered feishu_chat tool
[plugins] feishu_wiki: Registered feishu_wiki tool
[plugins] feishu_drive: Registered feishu_drive tool
[plugins] feishu_bitable: Registered bitable tools
│  - plugins.entries.feishu: plugin feishu: duplicate plugin id detected;  │
│    (/home/ubuntu/.openclaw/extensions/feishu/index.ts)                   │
Config warnings:\n- plugins.entries.feishu: plugin feishu: duplicate plugin id detected; later plugin may be overridden (/home/ubuntu/.openclaw/extensions/feishu/index.ts)
│ Feishu       │ feishu   │ loaded   │ stock:feishu/index.ts                                               │ 2026.3.13 │
│ @openclaw/   │ feishu   │ disabled │ global:feishu/index.ts                                              │ 2026.3.13 │
│ feishu       │          │          │ OpenClaw Feishu/Lark channel plugin (community maintained by        │           │
[plugins] plugins.allow is empty; discovered non-bundled plugins may auto-load: feishu (/home/ubuntu/.openclaw/extensions/feishu/index.ts). Set plugins.allow to explicit trusted ids.
[plugins] feishu_doc: Registered feishu_doc, feishu_app_scopes
[plugins] feishu_chat: Registered feishu_chat tool
[plugins] feishu_wiki: Registered feishu_wiki tool
[plugins] feishu_drive: Registered feishu_drive tool
[plugins] feishu_bitable: Registered bitable tools

3.2 查看飞书插件详细信息

bash 复制代码

$ openclaw plugins info feishu
Config warnings:\n- plugins.entries.feishu: plugin feishu: duplicate plugin id detected; later plugin may be overridden (/home/ubuntu/.openclaw/extensions/feishu/index.ts)
11:47:55 [plugins] plugins.allow is empty; discovered non-bundled plugins may auto-load: feishu (/home/ubuntu/.openclaw/extensions/feishu/index.ts). Set plugins.allow to explicit trusted ids.
11:47:57 [plugins] feishu_doc: Registered feishu_doc, feishu_app_scopes
11:47:57 [plugins] feishu_chat: Registered feishu_chat tool
11:47:57 [plugins] feishu_wiki: Registered feishu_wiki tool
11:47:57 [plugins] feishu_drive: Registered feishu_drive tool
11:47:57 [plugins] feishu_bitable: Registered bitable tools
Config warnings:\n- plugins.entries.feishu: plugin feishu: duplicate plugin id detected; later plugin may be overridden (/home/ubuntu/.openclaw/extensions/feishu/index.ts)

🦞 OpenClaw 2026.3.13 (61d171a)
   Welcome to the command line: where dreams compile and confidence segfaults.

│
◇  Config warnings ────────────────────────────────────────────────────────╮
│                                                                          │
│  - plugins.entries.feishu: plugin feishu: duplicate plugin id detected;  │
│    later plugin may be overridden                                        │
│    (/home/ubuntu/.openclaw/extensions/feishu/index.ts)                   │
│                                                                          │
├──────────────────────────────────────────────────────────────────────────╯
Feishu
id: feishu
Feishu/Lark channel plugin

Status: loaded
Source: ~/.nvm/versions/node/v24.14.0/lib/node_modules/openclaw/extensions/feishu/index.ts
Origin: bundled
Version: 2026.3.13
Tools: feishu_doc, feishu_app_scopes, feishu_chat, feishu_chat, feishu_wiki, feishu_drive, feishu_bitable_get_meta, feishu_bitable_list_fields, feishu_bitable_list_records, feishu_bitable_get_record, feishu_bitable_create_record, feishu_bitable_update_record, feishu_bitable_create_app, feishu_bitable_create_field

Install: npm
Spec: @openclaw/feishu
Install path: ~/.openclaw/extensions/feishu
Recorded version: 2026.3.13
Installed at: 2026-03-14T09:53:41.282Z
11:47:57 [plugins] plugins.allow is empty; discovered non-bundled plugins may auto-load: feishu (/home/ubuntu/.openclaw/extensions/feishu/index.ts). Set plugins.allow to explicit trusted ids.
11:47:57 [plugins] feishu_doc: Registered feishu_doc, feishu_app_scopes
11:47:57 [plugins] feishu_chat: Registered feishu_chat tool
11:47:57 [plugins] feishu_wiki: Registered feishu_wiki tool
11:47:57 [plugins] feishu_drive: Registered feishu_drive tool
11:47:57 [plugins] feishu_bitable: Registered bitable tools

npm 全局安装的 OpenClaw 插件与手动安装的 ~/.openclaw/extensions/ 的同名插件之间的冲突

3.3 查看 openclaw.json 配置文件

bash 复制代码

$ cat ~/.openclaw/openclaw.json | grep -A5 feishu
    "feishu": {
      "enabled": true,
      "appId": "cli_a9xxxxxxxxxxxxxcc",
      "appSecret": "EWENBHixxxxxxxxxxxxxxxxxxxxx",
      "connectionMode": "websocket",
      "domain": "feishu",
      "groupPolicy": "open"
    }
  },
  "gateway": {
    "port": 18789,
--
      "feishu": {
        "enabled": true
      }
    },
    "installs": {
      "feishu": {
        "source": "npm",
        "spec": "@openclaw/feishu",
        "installPath": "/home/ubuntu/.openclaw/extensions/feishu",
        "version": "2026.3.13",
        "resolvedName": "@openclaw/feishu",
        "resolvedVersion": "2026.3.13",
        "resolvedSpec": "@openclaw/feishu@2026.3.13",
        "integrity": "sha512-D5vPkgGZ9lfCQnDFlGrQN6NCSUYRgYW9xxxxxxxxxxxxxZ2eCXHjw9RVp/L75wjJ7NBQyfEw==",
        "shasum": "39128ff9xxxxxxxbe3f8xxxxa82exx",
        "resolvedAt": "2026-03-14T09:53:35.715Z",
        "installedAt": "2026-03-14T09:53:41.282Z"
      }

4. 分析原因

┌─────────────────────────────────────────────────────────────┐

│ OpenClaw 启动流程 │

├─────────────────────────────────────────────────────────────┤

│ │

│ 1. 加载配置文件 ~/.openclaw/openclaw.json │

│ ├── 解析 channels 配置（feishu 通道启用） │

│ ├── 解析 plugins 配置 │

│ │ ├── entries.feishu → 标记待加载 │

│ │ └── installs.feishu → 记录 npm 元数据 │

│ └── 检查 plugins.allow（空 → 自动发现模式） │

│ │

│ 2. 扫描插件目录（按优先级顺序） │

│ ├── ① Bundled 目录: node_modules/openclaw/extensions/ │

│ │ └── 发现 feishu → 注册 ID → 状态: loaded │

│ ├── ② Global 目录: ~/.openclaw/extensions/ │

│ │ └── 发现 feishu → ID 冲突 → 状态: disabled │

│ └── ③ Local 目录（项目级，本次无） │

│ │

│ 3. 冲突处理 │

│ ├── 输出 Config warnings: duplicate plugin id │

│ └── 保留先加载的（bundled），禁用后加载的（global） │

│ │

│ 4. 初始化生效的插件 │

│ └── 注册所有 feishu_xxx 工具到工具链 │

│ │

│ 5. 启动 Gateway（端口 18789） │

│ └── 等待飞书 WebSocket 连接 │

│ │

└─────────────────────────────────────────────────────────────┘

5. 解决问题

bash 复制代码

# 删除 global 物理文件，消除冲突源
rm -rf ~/.openclaw/extensions/feishu

然后打开 ~/.openclaw/openclaw.json 删除有关 "installs" 的内容

bash 复制代码

{
  "channels": {
    "feishu": {
      "enabled": true,
      "appId": "cli_a9xxxxxxxxxxxxxcc",
      "appSecret": "EWENBHixxxxxxxxxxxxxxxxxxxxx",
      "connectionMode": "websocket",
      "domain": "feishu",
      "groupPolicy": "open"
    }
  },
  "plugins": {
    "allow": ["feishu"],
    "entries": {
      "feishu": {
        "enabled": true
      }
    }
    // ← installs 块应该消失或不再包含 feishu
  }
}

重新启动：

bash 复制代码

$ openclaw gateway restart

然后查看插件：

bash 复制代码

$ openclaw plugins info feishu
22:00:49 [plugins] feishu_doc: Registered feishu_doc, feishu_app_scopes
22:00:49 [plugins] feishu_chat: Registered feishu_chat tool
22:00:49 [plugins] feishu_wiki: Registered feishu_wiki tool
22:00:49 [plugins] feishu_drive: Registered feishu_drive tool
22:00:49 [plugins] feishu_bitable: Registered bitable tools

🦞 OpenClaw 2026.3.13 (61d171a) --- I don't have opinions about tabs vs spaces. I have opinions about everything else.

Feishu
id: feishu
Feishu/Lark channel plugin

Status: loaded
Source: ~/.nvm/versions/node/v24.14.0/lib/node_modules/openclaw/extensions/feishu/index.ts
Origin: bundled
Version: 2026.3.13
Tools: feishu_doc, feishu_app_scopes, feishu_chat, feishu_chat, feishu_wiki, feishu_drive, feishu_bitable_get_meta, feishu_bitable_list_fields, feishu_bitable_list_records, feishu_bitable_get_record, feishu_bitable_create_record, feishu_bitable_update_record, feishu_bitable_create_app, feishu_bitable_create_field
22:00:49 [plugins] feishu_doc: Registered feishu_doc, feishu_app_scopes
22:00:49 [plugins] feishu_chat: Registered feishu_chat tool
22:00:49 [plugins] feishu_wiki: Registered feishu_wiki tool
22:00:49 [plugins] feishu_drive: Registered feishu_drive tool
22:00:49 [plugins] feishu_bitable: Registered bitable tools

$ openclaw plugins list | grep feishu
[plugins] feishu_doc: Registered feishu_doc, feishu_app_scopes
[plugins] feishu_chat: Registered feishu_chat tool
[plugins] feishu_wiki: Registered feishu_wiki tool
[plugins] feishu_drive: Registered feishu_drive tool
[plugins] feishu_bitable: Registered bitable tools
│ Feishu       │ feishu   │ loaded   │ stock:feishu/index.ts                                               │ 2026.3.13 │
[plugins] feishu_doc: Registered feishu_doc, feishu_app_scopes
[plugins] feishu_chat: Registered feishu_chat tool
[plugins] feishu_wiki: Registered feishu_wiki tool
[plugins] feishu_drive: Registered feishu_drive tool
[plugins] feishu_bitable: Registered bitable tools

大功告成！！！