openclaw - 💡(How to fix) Fix [Bug]: 飞书频道配置后无法被 Gateway 识别 — 始终显示 not configured / disabled

Summary

飞书（Feishu）频道配置完成后，Gateway 无法识别，始终显示 not configured, disabled。虽然插件代码本身可以正确解析配置，但 Gateway 运行时从未启动飞书频道，导致机器人完全无响应。

Environment

• OpenClaw 版本: 2026.5.26 (10ad3aa)
• 飞书插件版本: 测试了 @openclaw/[email protected] 和 @openclaw/[email protected]，两个版本均存在此问题
• 操作系统: macOS 26.2 (arm64)
• Node 版本: v22.22.0

Steps to Reproduce

1. 安装飞书插件: openclaw plugins install @openclaw/feishu
2. 在 config 中配置飞书频道凭据（通过 CLI 或直接编辑 openclaw.json）:

{
  "channels": {
    "feishu": {
      "enabled": true,
      "accounts": {
        "default": {
          "enabled": true,
          "appId": "cli_xxx",
          "appSecret": "xxx",
          "allowFrom": ["ou_xxx"]
        }
      }
    }
  }
}

1. 重启 Gateway
2. 运行 openclaw channels list --all → 显示 Feishu: installed, not configured, disabled
3. 运行 openclaw channels list → 显示 no configured chat channels
4. openclaw gateway call channels.status → channelAccounts: {}

Evidence

1. Gateway 启动日志 — 飞书频道从未被启动

gateway: starting channels and sidecars...
(browser server starts)
gateway: gateway ready

没有任何 feishu 相关的启动日志，也没有错误信息。

2. 插件代码本身可以正确解析配置

独立加载飞书插件模块测试配置解析:

$ node --input-type=module -e "
  import channelEntry from @openclaw/feishu/dist/channel-entry.js;
  import { readFileSync } from fs;
  const plugin = await channelEntry.loadChannelPlugin();
  const cfg = JSON.parse(readFileSync(openclaw.json, utf-8));
  console.log(plugin.config.listAccountIds(cfg));
  // Output: [default]
  const acc = plugin.config.resolveAccount(cfg, default);
  console.log(acc.enabled, acc.configured);
  // Output: true true
"

插件代码正确返回 listAccountIds: ["default"]，账户 enabled: true, configured: true。

3. Gateway 的 channels.status 始终返回空

{
  "channels": {},
  "channelAccounts": {},
  "channelDefaultAccountId": {}
}

4. 两种配置格式均尝试过，无效

• 扁平格式（channels.feishu.appId）— 旧版兼容格式
• 嵌套格式（channels.feishu.accounts.default.appId）— 新版标准格式

5. 交互式 CLI 也无法正常配置

openclaw channels add --channel feishu 不会提示输入 App ID/App Secret，仅写入 { "enabled": true }。

Root Cause Analysis

从代码分析来看，问题出在 Gateway 的 server-channels 模块中的 getRuntimeSnapshot() 和 startChannels()。飞书频道入口（channel-entry.js）正确注册，listAccountIds 和 resolveAccount 在独立测试中工作正常，但 Gateway 运行时未能将其纳入运行状态快照。可能是 createHybridChannelConfigAdapter 与 Gateway 的插件注册系统之间的集成问题。

Severity

High — 飞书机器人完全不可用。非配置问题，是代码层面的集成 bug。

Related

• 与 #53431 症状类似（飞书不响应），但根因不同：#53431 是 WebSocket 事件处理器注册问题（已在 2026.4.24 修复），本问题是频道配置完全不被 Gateway 识别。