企业官网建设流程全解析

1. OpenClaw 接入飞书报 duplicate plugin id detected 到底卡在哪

你如果在终端里跑openclaw gateway --port 18789 --verbose，看到plugins.entries.feishu: plugin feishu: duplicate plugin id detected; later plugin may be overridden这行 Config warnings，说明 OpenClaw 在启动阶段扫描插件目录时，发现了两个 ID 都叫feishu的插件实体。OpenClaw 的插件加载器对 ID 是强唯一约束，一旦重复，后加载的那个会被标记为 disabled，但警告会一直挂在启动日志里，Gateway 虽然能 online，飞书通道的工具注册却可能只生效一半。

这个报错本身不致命，但它会带来三个连锁问题：第一，plugins.allow为空时自动发现模式会把非 bundled 插件也拉进来，加载顺序不确定；第二，installs段里记录的 npm 安装元数据和实际文件路径可能对不上；第三，飞书工具（feishu_doc、feishu_chat、feishu_wiki、feishu_drive、feishu_bitable）的注册日志会重复打印，你很难判断到底哪个实例在真正干活。

适合谁看：已经在 Ubuntu 或 macOS 上通过 npm 全局装过 OpenClaw、又手动往~/.openclaw/extensions/放过飞书插件的人；或者用openclaw plugins install装过一次、后来升级版本没清理旧目录的人。这篇会把冲突来源、config.toml 骨架、清理步骤和验证命令一次讲透，顺带说明怎么用 TaoToken 统一 Key 通道，让接入后的模型调用不额外折腾。

2. 先搞清楚 duplicate plugin id 的三个来源

2.1 bundled 插件与 global 插件目录重叠

OpenClaw 的插件扫描有优先级顺序。bundled 目录在node_modules/openclaw/extensions/下，global 目录在~/.openclaw/extensions/下。飞书插件如果既作为 bundled 存在，又被 npm 全局安装写进了 global 目录，两个index.ts都会注册 IDfeishu。日志里Origin: bundled和Source: ~/.openclaw/extensions/feishu/index.ts同时出现，就是典型的重叠信号。

2.2 installs 段残留导致重复加载

~/.openclaw/openclaw.json里的installs.feishu记录了 npm 安装的 spec、installPath、version。如果你后来手动删了~/.openclaw/extensions/feishu目录，但installs段没清，OpenClaw 启动时仍会按记录去解析，解析失败或回退到 bundled，就可能出现同一 ID 被登记两次。

2.3 plugins.allow 为空触发自动发现

日志里那句plugins.allow is empty; discovered non-bundled plugins may auto-load是关键提示。allow 列表为空时，OpenClaw 会把扫描到的非 bundled 插件也纳入加载队列。你如果同时有 bundled feishu 和 global feishu，自动发现就会把两个都拉进来，冲突概率直接拉满。

3. TaoToken 前置：统一 Key 与 API 通道

在动手清插件之前，建议先把模型调用通道固定下来。OpenClaw 的飞书插件本身不绑定模型供应商，但工具调用、文档总结、bitable 读写这些动作最终都要走一次模型请求。如果 Key 散落在多个环境变量里，排障时你会分不清是插件冲突还是鉴权失败。

TaoToken 的做法是提供一个统一的 API 入口，把 Key 管理收敛到一处。你可以在控制台创建 Key，然后让 OpenClaw 的模型配置指向同一个 base URL。这样插件冲突排查和模型调用验证是两条独立的线，互不干扰。

具体操作：打开控制台 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite 创建 API Key，然后在 API Keys 页面 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys&utm_campaign=rewrite 复制出来。接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite ，里面有 base URL 和请求格式说明。API 端点本身是 https://taotoken.net/api ，不带额外参数。

注意：Key 只放在服务端环境变量或 OpenClaw 的配置里，不要写进飞书插件的index.ts，也不要提交到 git。

4. 可复制的 config.toml 插件段骨架

OpenClaw 的配置主文件通常是~/.openclaw/openclaw.json，但很多团队会用config.toml做插件段的声明式管理。下面这个骨架可以直接抄，重点是plugins.allow显式列出可信 ID，plugins.entries只保留一份 feishu，installs段要么删掉要么只留一条。

[plugins] # 显式声明允许加载的插件 ID，避免自动发现把重复实例拉进来 allow = ["feishu"] [plugins.entries.feishu] enabled = true # 指向唯一可信的插件入口，优先用 bundled 路径 entry = "stock:feishu/index.ts" [channels.feishu] enabled = true appId = "cli_a9xxxxxxxxxxxxxcc" appSecret = "EWENBHixxxxxxxxxxxxxxxxxxxxx" connectionMode = "websocket" domain = "feishu" groupPolicy = "open" [gateway] port = 18789

如果你用的是 JSON 版本，等价写法如下：

{ "plugins": { "allow": ["feishu"], "entries": { "feishu": { "enabled": true } } }, "channels": { "feishu": { "enabled": true, "appId": "cli_a9xxxxxxxxxxxxxcc", "appSecret": "EWENBHixxxxxxxxxxxxxxxxxxxxx", "connectionMode": "websocket", "domain": "feishu", "groupPolicy": "open" } }, "gateway": { "port": 18789 } }

关键点：installs段里不要再出现feishu。如果你之前用 npm 装过@openclaw/feishu，要么把整个installs.feishu删掉，要么确保它的installPath和 bundled 路径不重复。

5. 冲突清理步骤：从定位到消除

5.1 查找系统中所有 feishu 插件目录

find / -name "*feishu*" -type d 2>/dev/null

典型输出会同时出现两处：

/home/ubuntu/.nvm/versions/node/v24.14.0/lib/node_modules/openclaw/extensions/feishu /home/ubuntu/.openclaw/extensions/feishu

前者是 bundled，后者是 global 手动或 npm 安装的。冲突就来自这两处。

5.2 查看插件列表确认状态

openclaw plugins list | grep feishu

你会看到类似两行：

Feishu feishu loaded stock:feishu/index.ts 2026.3.13 @openclaw/feishu feishu disabled global:feishu/index.ts 2026.3.13

loaded的是先加载的 bundled，disabled的是后加载被覆盖的 global。警告里的later plugin may be overridden指的就是后者。

5.3 删除 global 重复目录

rm -rf ~/.openclaw/extensions/feishu

这一步消除物理文件层面的重复源。删之前确认你没有在 global 目录里改过飞书插件源码，如果有自定义改动，先备份再合并到 bundled 或改用 allow 显式指定。

5.4 清理 openclaw.json 里的 installs 段

打开~/.openclaw/openclaw.json，找到installs字段，删除feishu条目。如果整个installs只有 feishu 一项，直接删掉installs对象。同时确认plugins.allow里已经写了["feishu"]。

5.5 重启 Gateway 并观察日志

openclaw gateway restart

重启后日志里不应该再出现duplicate plugin id detected。如果还有，说明还有第三个目录或缓存没清，回到 5.1 再查一遍。

6. 验证请求与成功结果

6.1 查看插件详情

openclaw plugins info feishu

成功状态下输出应该只有一份：

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_wiki, feishu_drive, feishu_bitable_get_meta, ...

没有 Config warnings，没有 disabled 的第二实例。

6.2 确认工具注册日志

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

每个工具只注册一次，没有重复行。

6.3 用 TaoToken 通道验证模型调用

插件加载正常后，用一次模型对话确认 Key 通道可用。打开模型对话页面 https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_content=chat&utm_campaign=rewrite ，发一条测试消息，确认返回正常。如果你在 OpenClaw 里配置了模型 base URL，指向https://taotoken.net/api，请求头带Authorization: Bearer <你的Key>，就能和插件加载解耦验证。

curl -s https://taotoken.net/api/v1/models \ -H "Authorization: Bearer $TAOTOKEN_API_KEY" | head -20

返回模型列表说明 Key 和通道都通。这一步和飞书插件无关，但能帮你排除“到底是插件冲突还是鉴权失败”的混淆。

7. 本篇常见错排查

7.1 删了目录但警告还在

大概率是openclaw.json的installs.feishu没删，或者plugins.allow仍为空导致自动发现又扫到了缓存路径。检查~/.openclaw/下有没有.cache或plugins.lock之类的残留文件。

7.2 plugins.allow 写了 feishu 还是冲突

确认 allow 里的 ID 和插件实际注册的 ID 完全一致，大小写敏感。如果插件内部注册的是feishu，allow 写Feishu不会匹配。另外 allow 只约束非 bundled 插件，bundled 始终会加载，所以真正的解法是消除 global 重复目录。

7.3 飞书工具注册了但调用报权限错

这通常不是插件冲突，而是飞书应用本身的 scope 没开。检查飞书开放平台里feishu_doc、feishu_bitable对应的权限是否已授权。插件加载成功只代表工具注册了，不代表飞书侧授权通过。

7.4 重启后 Gateway 端口被占用

lsof -i :18789

如果有残留进程，先 kill 再 restart。端口占用会让 Gateway 起不来，日志里看不到插件加载结果，容易误判成插件问题。

7.5 长期编码场景建议用 Coding Plan

如果你不只是接飞书，还要跑长期编码或 Agent 任务，建议把模型通道切到 Coding Plan https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding-plan&utm_campaign=rewrite ，配额和并发策略更适合持续调用。插件冲突排查是一次性的，通道稳定性是长期的，两者分开管理。

8. 接入文档与后续验证入口

插件冲突清完之后，飞书通道的接入配置建议对照官方文档再核一遍参数。接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite ，里面有 base URL、鉴权头和常见错误码说明。API Keys 管理在 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api-keys&utm_campaign=rewrite ，控制台在 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite 。

如果你用的是 Claude Code 或 Anthropic 风格的调用，参考 https://taotoken.net/claude-code-anthropic?utm_source=taotoken_aicg_blog_end&utm_content=claude-code-anthropic&utm_campaign=rewrite 里的配置方式，把 base URL 指向 TaoToken 的 API 入口即可。官网首页 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 有完整的接入概览。

最后留一个实操习惯：每次升级 OpenClaw 版本后，先跑一遍find / -name "*feishu*" -type d和openclaw plugins list | grep feishu，确认只有一个 loaded 实例再启动 Gateway。这个动作花不到十秒，能省掉后面半小时的日志排查。