OpenClaw解決飛書 duplicate plugin id detected 問題

發(fā)布時(shí)間：2026-03-17 14:38:03 作者：愛學(xué)習(xí)的小道長

文章介紹了OpenClaw在啟動(dòng)過程中檢測到重復(fù)的feishu插件ID并導(dǎo)致沖突的問題,通過查找和刪除全局插件文件并調(diào)整配置文件,成功解決了這個(gè)問題，感興趣的朋友跟隨小編一起看看吧

1.查看日志

飛書運(yùn)行過程中產(chǎn)生警告：

$ 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	檢測到重復(fù)的插件 ID “feishu”
later plugin may be overridden	后加載的插件可能會(huì)被覆蓋
/home/ubuntu/.openclaw/extensions/feishu/index.ts	問題插件的文件路徑

核心問題：系統(tǒng)發(fā)現(xiàn)了兩個(gè) ID 相同的 “feishu” 插件，導(dǎo)致沖突，后加載的那個(gè)會(huì)被覆蓋。

常見原因：

插件被重復(fù)安裝到不同目錄
手動(dòng)復(fù)制插件文件導(dǎo)致重復(fù)
插件更新后舊版本未清理

查找系統(tǒng)中安裝的飛書插件：

$ 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 查看插件列表

$ 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 查看飛書插件詳細(xì)信息

$ 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 插件與手動(dòng)安裝的 ~/.openclaw/extensions/ 的同名插件之間的沖突

3.3 查看openclaw.json配置文件

$ 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 啟動(dòng)流程 │
├─────────────────────────────────────────────────────────────┤
│ │
│ 1. 加載配置文件 ~/.openclaw/openclaw.json │
│ ├── 解析 channels 配置（feishu 通道啟用） │
│ ├── 解析 plugins 配置 │
│ │ ├── entries.feishu → 標(biāo)記待加載 │
│ │ └── installs.feishu → 記錄 npm 元數(shù)據(jù) │
│ └── 檢查 plugins.allow（空 → 自動(dòng)發(fā)現(xiàn)模式） │
│ │
│ 2. 掃描插件目錄（按優(yōu)先級順序） │
│ ├── ① Bundled 目錄: node_modules/openclaw/extensions/ │
│ │ └── 發(fā)現(xiàn) feishu → 注冊 ID → 狀態(tài): loaded │
│ ├── ② Global 目錄: ~/.openclaw/extensions/ │
│ │ └── 發(fā)現(xiàn) feishu → ID 沖突 → 狀態(tài): disabled │
│ └── ③ Local 目錄（項(xiàng)目級，本次無） │
│ │
│ 3. 沖突處理 │
│ ├── 輸出 Config warnings: duplicate plugin id │
│ └── 保留先加載的（bundled），禁用后加載的（global） │
│ │
│ 4. 初始化生效的插件 │
│ └── 注冊所有 feishu_xxx 工具到工具鏈 │
│ │
│ 5. 啟動(dòng) Gateway（端口 18789） │
│ └── 等待飛書 WebSocket 連接 │
│ │
└─────────────────────────────────────────────────────────────┘

5. 解決問題

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

然后打開 ~/.openclaw/openclaw.json 刪除有關(guān) “installs” 的內(nèi)容

{
  "channels": {
    "feishu": {
      "enabled": true,
      "appId": "cli_a9xxxxxxxxxxxxxcc",
      "appSecret": "EWENBHixxxxxxxxxxxxxxxxxxxxx",
      "connectionMode": "websocket",
      "domain": "feishu",
      "groupPolicy": "open"
    }
  },
  "plugins": {
    "allow": ["feishu"],
    "entries": {
      "feishu": {
        "enabled": true
      }
    }
    // ← installs 塊應(yīng)該消失或不再包含 feishu
  }
}

重新啟動(dòng)：

$ openclaw gateway restart

然后查看插件：

$ 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

大功告成?。?！

到此這篇關(guān)于OpenClaw解決飛書 duplicate plugin id detected 問題的文章就介紹到這了,更多相關(guān)OpenClaw 飛書 duplicate plugin id detected內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！