Feishu / Lark

OpenClaw Feishu/Lark channel plugin. Community maintained by @m1heng.

The Feishu/Lark plugin bridges OpenClaw with ByteDance's enterprise communication platform, bringing AI agent capabilities directly into the workspace tool used by millions of teams across China and the Asia-Pacific region. Feishu (飞书) is the Chinese-domestic version while Lark is the international variant — this plugin supports both seamlessly through a unified channel adapter. At its core, the plugin registers as a Feishu bot application that listens for messages via webhook events, processes them through the OpenClaw gateway, and delivers responses back into Feishu conversations. It supports individual chats, group mentions, rich card messages, and interactive message actions. The architecture leverages Feishu's Event Subscription API for real-time message delivery and the Bot API for sending responses, including text, images, and interactive cards. This is one of the highest-traffic OpenClaw plugins with over 108K weekly downloads, reflecting the massive demand for AI assistants in Chinese enterprise environments. It was originally community-maintained by @m1heng and later adopted into the official OpenClaw package family. The plugin competes with two other Feishu/Lark plugins — one from the official Lark Suite team and another from the Feishu OAPI team — giving users choices based on their specific deployment needs. Ideal for teams already embedded in the Feishu/Lark ecosystem who want to add AI capabilities without switching platforms. Not recommended if you're outside China/APAC and don't already use Feishu — consider Slack, Discord, or Teams instead.

Tags: channel, messaging, enterprise

Use Cases

  • Enterprise AI assistant accessible directly in team Feishu group chats for quick Q&A and task automation
  • Automated daily standup summaries and meeting note generation within Feishu workspaces
  • Customer support bot in Feishu-connected helpdesk channels for internal IT teams
  • Code review assistant that integrates with Feishu notifications from CI/CD pipelines
  • Knowledge base search and retrieval agent for organizations using Feishu Docs
  • Cross-language translation assistant for multinational teams communicating via Lark

Tips

  • Use Cloudflare Tunnel or ngrok for development to expose your local OpenClaw instance to Feishu webhooks
  • Start with the official @openclaw/feishu plugin before trying third-party alternatives — it has the most community support
  • Set up event subscriptions for 'im.message.receive_v1' in the Feishu Open Platform to receive messages
  • Use interactive card messages for richer responses — they support buttons, selections, and formatted layouts
  • Test with a personal Feishu workspace first before deploying to your organization's tenant
  • Monitor the Feishu API rate limits dashboard to avoid throttling during high-traffic periods
  • Keep your App Secret in environment variables rather than hardcoding in config files

Known Issues & Gotchas

  • You need a public HTTPS URL for the webhook endpoint — localhost won't work without a tunnel like ngrok or Cloudflare Tunnel
  • Feishu and Lark use different API endpoints; make sure your app is registered on the correct platform (feishu.cn vs larksuite.com)
  • The verification token and encrypt key are optional but strongly recommended for production deployments
  • Group chats require the bot to be explicitly added and mentioned — it won't see messages otherwise
  • If you have multiple Feishu plugins installed (official, larksuite, m1heng), they can conflict — only enable one at a time
  • Bot permissions must be explicitly granted in the Feishu Open Platform dashboard before messages will flow
  • Event subscriptions need to be configured in the Feishu app settings — the plugin alone doesn't register them automatically

Alternatives

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

Community Feedback

Our OpenClaw provisioning now natively supports the Feishu/Lark channel. It was an interesting implementation.

— Reddit r/OpenClawCloud

Key changes: Feishu/Lark - first Chinese chat client. Faster builds. Security hardening across the board.

— Reddit r/myclaw

Does OpenClaw 2026.2.2 support Feishu and Lark? Yes. These platforms now integrate directly with automation flows.

— Reddit r/AISEOInsider

Frequently Asked Questions

What's the difference between @openclaw/feishu, @larksuite/openclaw-lark, and @larksuiteoapi/feishu-openclaw-plugin?

All three connect OpenClaw to Feishu/Lark but differ in maintainer and focus. @openclaw/feishu is the official OpenClaw-maintained plugin (108K downloads), @larksuite/openclaw-lark is built by the Lark Suite team (71K downloads), and @larksuiteoapi/feishu-openclaw-plugin is from ByteDance's Feishu team (25K downloads). Use the one matching your platform — Lark international or Feishu China-domestic.

Do I need a public URL for Feishu webhook events?

Yes. Feishu sends event callbacks to your registered webhook URL, which must be publicly accessible over HTTPS. For local development, use ngrok or Cloudflare Tunnel to expose your OpenClaw instance.

Can I use this plugin with both Feishu (China) and Lark (International)?

Yes, but you need to register your bot on the correct platform. Feishu uses feishu.cn endpoints while Lark uses larksuite.com. Set the apiBase config accordingly. You can't use a single app registration for both.

Does the Feishu plugin support group chats?

Yes, but the bot must be explicitly added to the group and @mentioned to trigger a response. You can configure group allowlists to control which groups the bot responds in.

How do I handle Feishu API rate limits?

Feishu enforces rate limits of roughly 100 messages per minute per bot for standard tiers. OpenClaw queues outgoing messages automatically, but for high-traffic scenarios consider upgrading your Feishu app tier or implementing message batching.

Why am I getting verification errors when setting up the webhook?

Feishu sends a verification challenge to your webhook URL during setup. Make sure your OpenClaw gateway is running and accessible at the registered URL before configuring the webhook in the Feishu Open Platform dashboard.

Configuration Examples

Basic Feishu Bot Setup

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

Feishu with Encryption and Group Chat

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

Lark (International) Configuration

channels:
  feishu:
    enabled: true
    appId: cli_a1b2c3d4e5f6
    appSecret: ${LARK_APP_SECRET}
    apiBase: https://open.larksuite.com
    verificationToken: ${LARK_VERIFY_TOKEN}

Installation

openclaw plugins install @openclaw/feishu