Skip to content

[Bug]: bundled Feishu plugin fails to load after documented install flow #39986

@Takhoffman

Description

@Takhoffman

Summary

openclaw plugins install @openclaw/feishu can still leave Feishu unloadable because the bundled Feishu plugin wins discovery precedence and the published root package is missing @larksuiteoapi/node-sdk.

Steps to reproduce

  1. Install openclaw from npm.
  2. Run openclaw plugins install @openclaw/feishu.
  3. Restart the gateway or trigger plugin loading.

Expected behavior

Feishu loads successfully after following the documented install flow.

Actual behavior

OpenClaw prefers the bundled Feishu plugin and fails to load it with Cannot find module '@larksuiteoapi/node-sdk'.

Impact

  • Affected: npm-installed OpenClaw users trying to use Feishu
  • Severity: High for Feishu onboarding because setup appears successful but the plugin still fails at runtime
  • Frequency: 100% repro on affected builds
  • Consequence: Feishu cannot be loaded without a manual config override

Temporary workaround

Add the installed Feishu path to plugins.load.paths so the config-sourced plugin overrides the broken bundled copy.

{
  plugins: {
    load: {
      paths: ["/home/user/.openclaw/extensions/feishu"],
    },
    entries: {
      feishu: { enabled: true },
    },
  },
}

Then restart the gateway.

Acceptance criteria

  • Root package includes @larksuiteoapi/node-sdk.
  • Bundled Feishu loads on npm-installed OpenClaw without manual override.
  • Feishu docs stop telling current-release users to do a separate install by default.
  • No change to general scoped npm plugin install semantics.

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't workingmaintainerMaintainer-authored PR

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions