Feishu (Official Feishu Team)

OpenClaw Feishu/Lark channel plugin by the official Feishu team at ByteDance.

The Feishu Official plugin is developed by the Feishu OAPI (Open API) team at ByteDance — the same team that builds and maintains the Feishu developer platform. With 25K weekly downloads, it's the third most popular Feishu/Lark integration, positioned between the @larksuite/openclaw-lark plugin (71K, Lark international focus) and the @m1heng-clawd/feishu community plugin (13K). Like its sibling @larksuite/openclaw-lark, this plugin provides comprehensive workspace integration — connecting your OpenClaw agent to messages, documents, bases, and more within the Feishu/Lark ecosystem. The key difference is provenance and target audience: this comes from the Feishu-specific OAPI team and is published under the @larksuiteoapi npm scope, while the other comes from the broader Lark Suite team under @larksuite. The plugin seamlessly connects your OpenClaw Agent to your Feishu/Lark workspace, empowering it to directly read from and write to messages, documents, bases, and other workspace resources. It shares the same security considerations as the @larksuite/openclaw-lark plugin — OpenClaw acts under your authorized identity, creating risks around sensitive data and unauthorized operations. Best for teams primarily using Feishu (the China-domestic version) who want an official ByteDance-backed integration. If you're on Lark (international), the @larksuite/openclaw-lark plugin may be a more natural fit. If you want the simplest setup without deep workspace features, @openclaw/feishu is the lightweight option.

Tags: channel, messaging, enterprise

Use Cases

  • Feishu-native workspace AI assistant for Chinese enterprise teams
  • Document reading and search bot within Feishu Docs for knowledge management
  • Bitable data query assistant for teams using Feishu's no-code database features
  • Internal communication bot for companies standardized on Feishu as their enterprise platform
  • Automated message handling and response generation in Feishu group chats and DMs

Tips

  • Choose this plugin if your team primarily uses Feishu (feishu.cn, China-domestic) rather than Lark (international)
  • Start with basic messaging permissions before enabling docs, base, or calendar access
  • Only enable one Feishu/Lark plugin at a time to avoid channel conflicts
  • Check the plugin's npm page for the most up-to-date permission requirements
  • Use encrypted events (encryptKey) for production deployments to protect webhook payloads
  • The Feishu OAPI team maintains official documentation — check open.feishu.cn for API details

Known Issues & Gotchas

  • This is NOT the same as @larksuite/openclaw-lark — different npm scope, different team, though similar capabilities from the same parent company
  • The Feishu Open Platform dashboard is primarily in Chinese — use browser translation if needed
  • Event subscriptions must be manually configured in the Feishu app settings before messages flow
  • Permission scope names can differ slightly between the Feishu console UI and the plugin documentation
  • Don't install multiple Feishu/Lark plugins simultaneously — they can conflict with each other
  • The plugin carries the same security warnings as @larksuite/openclaw-lark: don't relax default protections

Alternatives

  • @larksuite/openclaw-lark
  • @openclaw/feishu
  • @m1heng-clawd/feishu

Community Feedback

It seamlessly connects your OpenClaw Agent to your Feishu/Lark workspace, empowering it to directly read from and write to messages, documents, bases, and other workspace resources.

— npm

Three Feishu plugins and they all work — pick whichever matches your deployment. larksuiteoapi is the Feishu-native one from ByteDance's own team.

— OpenClaw Community

Frequently Asked Questions

What's the difference between this and @larksuite/openclaw-lark?

Both come from ByteDance but different teams. @larksuiteoapi/feishu-openclaw-plugin is from the Feishu OAPI team (25K downloads), targeting Feishu China-domestic users. @larksuite/openclaw-lark is from the broader Lark Suite team (71K downloads), targeting Lark international users. Capabilities are very similar.

Should I use this or the @openclaw/feishu official plugin?

@openclaw/feishu (108K downloads) is simpler and focused on messaging. This plugin from the Feishu OAPI team provides deeper workspace integration (docs, bases, etc.). Choose @openclaw/feishu for quick chat setup, this plugin for full workspace automation.

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

Yes, the plugin supports both Feishu and Lark. However, if you're primarily using Lark (international), the @larksuite/openclaw-lark plugin may be a more natural fit as it's specifically maintained for the Lark audience.

Is this plugin officially supported by ByteDance?

Yes, it's published under the @larksuiteoapi npm scope and maintained by ByteDance's Feishu Open API team. It's an officially backed integration, though OpenClaw itself is an independent project.

What happens if I install multiple Feishu/Lark plugins?

They can conflict with each other since they register for the same channel events. Only enable one Feishu/Lark plugin at a time. Choose the one that best matches your needs and disable the others.

Configuration Examples

Basic Feishu OAPI Setup

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

Feishu with Encrypted Events

channels:
  feishu:
    enabled: true
    appId: cli_a1b2c3d4e5f6
    appSecret: ${FEISHU_APP_SECRET}
    verificationToken: ${FEISHU_VERIFY_TOKEN}
    encryptKey: ${FEISHU_ENCRYPT_KEY}
    dm:
      policy: pairing

Installation

openclaw plugins install @larksuiteoapi/feishu-openclaw-plugin