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
大功告成!!!