openclaw - 💡(How to fix) Fix [Bug]: Behavior bug (incorrect output/state without crash)

Bug type

Behavior bug (incorrect output/state without crash)

Beta release blocker

No

Summary

飞书插件 registerFull() 回调未被调用，feishu_doc/feishu_wiki 等工具未注入 agent 运行时

环境：

• OpenClaw 版本：2026.5.7（Docker 部署）
• @openclaw/feishu 版本：2026.5.7
• Node 版本：v24.14.0
• 操作系统：Docker (Linux) on Windows

关联 issue: #59571（声称在 v2026.4.26 已修复，但 v2026.5.7 仍然存在）

已排查确认： ✅ channels.feishu.tools.wiki = true ✅ channels.feishu.tools.doc = true ✅ channels.feishu.tools.drive = true ✅ channels.feishu.tools.scopes = true ✅ plugins.allow = ["feishu"] ✅ plugins.entries.feishu.enabled = true ✅ agent skills 列表包含 feishu-doc, feishu-wiki, feishu-drive, feishu-perm ✅ openclaw skills list 显示所有 feishu skills 为 "✓ ready" ✅ openclaw doctor 报告 Skills eligible=10, missing=0, blocked=0, errors=0 ✅ 飞书消息收发正常（channel 部分工作正常） ✅ appId/appSecret 配置在 channels.feishu.accounts.default 和 channels.feishu 顶层 ❌ agent 运行时无法看到 feishu_doc/feishu_wiki 工具 ❌ 启动日志中无任何 registerFull/registerFeishuDocTools 相关记录 ❌ agent 收到 wiki 链接后 fallback 到 web_fetch（被登录墙挡住）

Steps to reproduce

1. Docker 部署 OpenClaw 2026.5.7，按引导配置飞书渠道
2. npm install @openclaw/feishu（插件 origin 为 "global"，非 "bundled"）
3. 配置 channels.feishu.tools.doc = true, channels.feishu.tools.wiki = true
4. 将 feishu-doc, feishu-wiki 加入 agent skills 列表
5. 重启 gateway
6. 在飞书对话中发送 wiki 链接，要求 agent 用 feishu_wiki 工具读取

结果：

• agent 不识别 feishu_wiki 工具，fallback 到 web_fetch
• dispatch complete (queuedFinal=false, replies=0)
• 启动日志中完全没有 registerFull() 或 registerFeishuDocTools() 的调用记录

代码分析： 在 @openclaw/feishu/dist/index.js 中，registerFull() 回调包含： registerFeishuDocTools(api); registerFeishuWikiTools(api); registerFeishuDriveTools(api); registerFeishuPermTools(api); registerFeishuBitableTools(api);

但对于 origin="global" 的插件，这个回调似乎从未被 OpenClaw 核心框架调用。 Channel 部分（消息收发）正常工作，说明插件本身加载成功，但工具注册路径断裂。

plugins/installs.json 中 feishu 插件信息： "origin": "global" "deferConfiguredChannelFullLoadUntilAfterListen": false "enabled": true

Expected behavior

agent 运行时应能看到并调用 feishu_doc、feishu_wiki、feishu_drive、feishu_perm、feishu_bitable_* 等工具，与 #59571 中描述的修复行为一致。

Actual behavior

agent 运行时没有任何 feishu 工具可用。启动日志中无 registerFull/registerFeishuDocTools 相关记录。agent 收到飞书 wiki 链接后 fallback 到 web_fetch（失败），最终 dispatch complete (replies=0)。

OpenClaw version

2026.5.7

Operating system

Docker (Linux) on Windows 10

Install method

Docker

Model

deepseek/deepseek-v4-flash

Provider / routing chain

deepseek

Additional provider/model setup details

N/A - 与模型无关，是插件工具注册问题

Logs, screenshots, and evidence

Impact and severity

Critical - 所有依赖飞书文档读写的工作流完全无法使用。影响 wiki 读取、文档编辑、多维表格查询等核心业务功能。

Additional information

相关日志片段：

1. 启动日志 - 仅有 channel 启动，无工具注册： [channels/feishu] starting feishu[default] (mode: websocket) [channels/feishu] feishu[default]: WebSocket client started （无 registerFull/registerFeishuDocTools 相关日志）

2. agent 处理 wiki 链接时 fallback 到 web_fetch： [tools] web_fetch failed: Web fetch extraction failed: Readability, provider fallback, and basic HTML cleanup returned no content.

3. agent 最终无回复： [channels/feishu] feishu[default]: dispatch complete (queuedFinal=false, replies=0)

4. 插件加载警告（设置 plugins.allow 前）： [plugins] plugins.allow is empty; discovered non-bundled plugins may auto-load: feishu

5. openclaw doctor 输出： Skills eligible: 10, Missing requirements: 0, Blocked by allowlist: 0 Plugins: Loaded 67, Imported 0, Disabled 27, Errors 0

怀疑根因：defineBundledChannelEntry 中的 registerFull() 回调对 origin="global" 的插件未被框架正确调度。