Feishu (m1heng Community)

OpenClaw Feishu/Lark channel plugin. Community-maintained alternative with Claude integration.

The m1heng Feishu plugin is the pioneering community-maintained Feishu/Lark integration for OpenClaw, originally created before the official ByteDance plugins existed. With 13K weekly downloads and a thriving Chinese developer community, it remains a popular choice — especially among users who value comprehensive documentation, active community support, and practical troubleshooting resources. The plugin connects OpenClaw to Feishu/Lark through the standard bot API with event subscriptions. It provides a full-featured messaging integration with support for DMs, group chats (with @mention), message history, image/file handling, and user info resolution for speaker attribution. The extensive permission model covers messaging, contacts, docs, base, wiki, calendar, tasks, and reactions — giving it depth comparable to the official plugins. What sets this plugin apart is its community ecosystem. The GitHub repository includes a comprehensive Wiki with configuration tutorials, common issues, and usage tips (all in Chinese). There's an active Discussions forum for open-ended Q&A and structured Issue templates for bug reports. The project has corporate sponsorship from YouYun Zhisuan (UCloud's AI cloud platform), indicating commercial-grade reliability expectations. The plugin also provides detailed Windows troubleshooting for the common `spawn npm ENOENT` error, with multiple installation fallback options (npm pack, curl tarball, manual download). This practical attention to real user problems across platforms makes it especially accessible to the Chinese OpenClaw community. Best for Chinese-speaking OpenClaw users who value community documentation and support. The Wiki and Discussions are primarily in Chinese, making it the most accessible option for native Chinese speakers.

Tags: channel, messaging, community

Use Cases

  • Chinese developer's personal AI assistant in Feishu for daily work and research
  • Team chat bot in Feishu group conversations with @mention activation
  • Document and knowledge base assistant using Feishu Docs and Wiki integration
  • Task management bot leveraging Feishu's task and bitable capabilities
  • Internal helpdesk bot for Chinese companies using Feishu as their enterprise platform

Tips

  • Check the Wiki first: https://github.com/m1heng/clawdbot-feishu/wiki — it has tutorials, common issues, and tips (in Chinese)
  • Use Discussions for open-ended Q&A and structured Issue templates for bug reports
  • On Windows, the most reliable install method is downloading the tarball directly from npm
  • Start with the minimum required permissions (messaging) before adding docs, base, or calendar access
  • The plugin supports updating via `openclaw plugins update feishu`
  • For troubleshooting, check the existing Discussions before opening a new issue — many common problems are already answered
  • Grant read-only permissions first, then add write permissions incrementally as needed

Known Issues & Gotchas

  • On Windows, `openclaw plugins install` may fail with 'spawn npm ENOENT' — use `npm pack @m1heng-clawd/feishu` then install from the .tgz file
  • Check installed version with `openclaw plugins list | rg -i feishu` — version mismatches cause silent failures
  • The Wiki and most community resources are in Chinese — use browser translation if needed
  • Don't install alongside other Feishu/Lark plugins — they conflict on the same channel events
  • Event subscriptions must be manually configured in the Feishu Open Platform — the plugin doesn't auto-register them
  • The contact:user.base:readonly permission is needed for resolving sender display names in group chats
  • requireMention: false in groups requires the sensitive im:message.group_msg permission

Alternatives

  • @larksuite/openclaw-lark
  • @larksuiteoapi/feishu-openclaw-plugin
  • @openclaw/feishu

Community Feedback

Community contributions are welcome! Check Discussions for common solutions first, then open a structured Issue Form if needed.

— GitHub

Thanks to our sponsors for supporting the project. If you need an API key platform whose models can be used as an OpenClaw provider, YouYun Zhisuan is worth considering.

— GitHub

m1heng's plugin was the first Feishu integration — it paved the way before ByteDance built their own. Still very active with great Chinese community.

— OpenClaw Community

Frequently Asked Questions

Why choose this over the official ByteDance plugins?

The m1heng plugin was the first Feishu integration and has the most extensive Chinese-language community documentation. The Wiki, Discussions, and Issue templates provide better troubleshooting resources for Chinese-speaking users. The official plugins may have deeper features, but this one has broader community knowledge.

How do I fix 'spawn npm ENOENT' on Windows?

This is a known Windows issue. Download the latest package tarball using `npm pack @m1heng-clawd/feishu` and install from the .tgz file: `openclaw plugins install ./m1heng-clawd-feishu-<version>.tgz`. Alternative: use curl to download from the npm registry directly.

Is this plugin still actively maintained?

Yes. It has 13K weekly downloads, regular version updates (latest: 0.1.17), active Discussions, and corporate sponsorship from YouYun Zhisuan. The community is engaged and responsive to issues.

Can I use this with Lark (international) instead of Feishu?

Yes, the plugin supports both Feishu and Lark. Configure the appropriate API endpoints for your platform. However, if you're primarily on Lark (international), the @larksuite/openclaw-lark plugin may have better documentation for your use case.

What permissions do I need for basic messaging?

Minimum: im:message (messaging), im:message.p2p_msg:readonly (read DMs), im:message.group_at_msg:readonly (group @mentions), im:message:send_as_bot (send messages), im:resource (upload/download media). Add contact:user.base:readonly for display name resolution.

Configuration Examples

Basic Feishu Setup

channels:
  feishu:
    enabled: true
    appId: cli_a1b2c3d4e5f6
    appSecret: ${FEISHU_APP_SECRET}
    verificationToken: ${FEISHU_VERIFY_TOKEN}

Feishu with Group Chat and User Resolution

channels:
  feishu:
    enabled: true
    appId: cli_a1b2c3d4e5f6
    appSecret: ${FEISHU_APP_SECRET}
    verificationToken: ${FEISHU_VERIFY_TOKEN}
    encryptKey: ${FEISHU_ENCRYPT_KEY}
    groups:
      policy: allowlist
      allowed:
        - oc_xxxxxxxxxxxxxxxx
    resolveUserNames: true

Windows Manual Install from Tarball

# PowerShell
$tarball = npm view @m1heng-clawd/feishu dist.tarball
curl.exe -L $tarball -o feishu-latest.tgz
openclaw plugins install .\feishu-latest.tgz

Installation

openclaw plugins install @m1heng-clawd/feishu