openclaw - 💡(How to fix) Fix [Bug]: 2026.3.28 bundled feishu channelConfigs schema overrides openclaw-lark plugin schema even when bundled plugin is disabled [2 comments, 2 participants]

Summary

When upgrading from 2026.3.24 to 2026.3.28, Gateway refuses to start with:

channels.feishu: invalid config: must NOT have additional properties
channels.feishu.accounts.jeeves: invalid config: must NOT have additional properties
channels.feishu.accounts.ivy: invalid config: must NOT have additional properties
channels.feishu.accounts.crichton: invalid config: must NOT have additional properties
channels.feishu.accounts.marple: invalid config: must NOT have additional properties

The external plugin @larksuite/openclaw-lark (2026.3.26) registers channel id feishu with a full config schema that includes keys like replyMode, footer, botName, blockStreaming, markdown, dedup, threadSession, and uat. However, the bundled @openclaw/feishu plugin also registers channel id feishu with a channelConfigs schema (new in 2026.3.28) that does not include these keys and sets additionalProperties: false.

The bundled plugin is explicitly disabled (plugins.entries.feishu.enabled: false), but its schema still takes priority during config validation.

Root Cause (code-verified)

2026.3.28 introduced channelConfigs in BUNDLED_PLUGIN_METADATA for the bundled feishu plugin (chat-meta-xAV2SRO1.js:3563):

channelConfigs: { feishu: {
  schema: {
    type: "object",
    properties: { enabled, defaultAccount, appId, appSecret, ... },
    additionalProperties: false  // rejects any key not listed
  }
}}

This schema is missing keys that @larksuite/openclaw-lark defines and users rely on:

• replyMode — streaming card reply mode
• footer — card footer config (elapsed/status/tokens)
• botName — per-account bot display name
• blockStreaming, markdown, dedup, threadSession, uat

In buildBundledChannelMaps(), bundled channel schemas are added to configSchemaMap unconditionally, without checking whether the bundled plugin is disabled. External plugins loaded later cannot override the bundled schema for the same channel id.

2026.3.24 did not have this issue because channelConfigs did not exist — the bundled feishu entry only had configSchema: { additionalProperties: false, properties: {} } at the plugin level, and channel config validation was delegated to the loaded plugin at runtime.

Steps to Reproduce

1. Install @larksuite/[email protected]
2. Configure plugins.entries.feishu.enabled: false and plugins.entries.openclaw-lark.enabled: true
3. Add any openclaw-lark-specific config key under channels.feishu (e.g., footer, replyMode, botName in accounts)
4. Upgrade to OpenClaw 2026.3.28
5. Run openclaw gateway status — fails with "must NOT have additional properties"

Config snippet

{
  "channels": {
    "feishu": {
      "enabled": true,
      "domain": "lark",
      "connectionMode": "websocket",
      "requireMention": false,
      "streaming": true,
      "replyMode": "streaming",
      "footer": { "status": true, "elapsed": true },
      "accounts": {
        "jeeves": {
          "appId": "cli_xxx",
          "appSecret": "***",
          "domain": "lark",
          "botName": "Jeeves",
          "dmPolicy": "allowlist",
          "groupPolicy": "open"
        }
      }
    }
  },
  "plugins": {
    "entries": {
      "feishu": { "enabled": false },
      "openclaw-lark": { "enabled": true }
    }
  }
}

Expected Behavior

When a bundled channel plugin is disabled and an external plugin registers the same channel id, the external plugin's config schema should be used for validation (or at minimum, the bundled schema should not reject keys the external plugin defines).

Environment

• OpenClaw: 2026.3.28
• @larksuite/openclaw-lark: 2026.3.26
• macOS arm64, Node 22.22.1

Related

• #56794 (same root cause, reported by another user)
• #56882 (footer config rejected)