m1heng/clawdbot-feishu

Overview: Enterprise-Grade Feishu Integration for OpenClaw

The clawdbot-feishu project by m1heng represents a sophisticated channel plugin that bridges OpenClaw AI agents with Feishu (Lark), one of Asia's leading enterprise collaboration platforms. With over 2,600 GitHub stars and an active community of 307 forks, this TypeScript-based integration has become the go-to solution for organizations looking to deploy conversational AI within their Feishu workspaces.

This plugin transforms Feishu into a powerful interface for AI interactions, enabling teams to leverage OpenClaw capabilities directly within their existing communication workflows. The project's MIT license and active maintenance (last updated February 2025) make it an attractive option for both commercial and open-source deployments.

Key Features and Capabilities

Multi-Modal Communication Support

The plugin excels in handling diverse communication scenarios within Feishu environments. It supports both direct messaging (DM) and group conversations with configurable policies including 'pairing', 'open', and 'allowlist' modes. The intelligent @mention detection ensures bots only respond when explicitly invoked in group settings, preventing unwanted interruptions.

A standout feature is the flexible render mode system that adapts message formatting based on content complexity. The 'auto' mode intelligently switches between plain text and rich interactive cards, while 'card' mode provides full Markdown rendering with syntax highlighting, tables, and clickable links—essential for technical discussions and code sharing.

Dynamic Agent Creation with Workspace Isolation

Perhaps the most innovative feature is the dynamic agent creation capability, which automatically provisions isolated agent instances for each user. This architecture ensures complete separation of conversation history, memory (MEMORY.md), and workspace files across users. Organizations can configure workspace templates like ~/workspaces/feishu-{agentId} to maintain clean organizational structures, with optional limits on total agent instances to manage resource consumption.

Comprehensive Feishu Resource Access

The plugin provides deep integration with Feishu's document ecosystem through specialized tools:

• feishu_doc: Read, create, and edit Feishu documents with Markdown-to-blocks conversion
• feishu_drive: Manage folders, upload images, and organize files
• feishu_wiki: Access wiki spaces, create nodes, and perform searches
• feishu_bitable: Interact with structured databases and records

Each tool supports granular permission configurations from read-only to full read-write access, allowing administrators to balance functionality with security requirements.

Installation and Configuration

Quick Setup

Installation follows OpenClaw's standard plugin architecture with simple CLI commands:

openclaw plugins install @m1heng-clawd/feishu

Upgrading is equally straightforward: openclaw plugins update feishu

Feishu Open Platform Configuration

The setup process requires creating a self-built app in the Feishu Open Platform and configuring several critical components. Administrators must obtain App ID and App Secret credentials, then configure extensive permissions across messaging, contacts, and document access scopes.

A commonly overlooked step is event subscription configuration. The plugin documentation emphasizes that the bot can send messages but won't receive them without proper event setup. The recommended approach uses long connection mode with subscriptions to im.message.receive_v1 and related events.

The plugin supports both websocket (recommended) and webhook connection modes, with websocket offering more reliable real-time message delivery. For organizations with private Feishu deployments, custom domain configuration is supported through the domain parameter.

Resource Sharing Requirements

A critical security consideration: Feishu bots operate on a permission model where they can only access explicitly shared resources. For Drive operations, administrators must manually share folders with the bot. Similarly, wiki spaces require adding the bot as a member through the space settings. This deliberate security design prevents unauthorized access but requires careful initial setup.

Technical Architecture

Built entirely in TypeScript, the project demonstrates professional software engineering practices with structured directories for agents, skills, scripts, and core source code. The inclusion of .claude/ directories suggests integration with Claude AI models, while the openclaw.plugin.json manifest ensures compatibility with the OpenClaw plugin ecosystem.

The 45 commits reflect steady development, with the most recent push in February 2025 indicating active maintenance. The presence of comprehensive configuration files (tsconfig.json, pnpm-lock.yaml) demonstrates modern Node.js development practices.

Community and Support

With 2,678 stars and 307 forks, clawdbot-feishu enjoys strong community adoption. The project maintains 77 open issues, suggesting an engaged user base actively reporting bugs and requesting features. The availability of both English and Chinese documentation reflects its primary adoption in Asian markets where Feishu dominates enterprise communication.

A dedicated Wiki provides configuration tutorials, FAQ, and usage tips—essential resources for enterprises deploying this integration at scale. The active pull request queue (25 open) indicates ongoing community contributions.

Comparison with Alternatives

While Feishu offers native bot capabilities, clawdbot-feishu differentiates itself through deep rogerli007/my-openclaw-page integration, enabling access to the broader AI agent ecosystem. Compared to building custom Feishu bots, this plugin provides out-of-the-box conversation management, workspace isolation, and multi-modal rendering—features that would require significant development effort to replicate.

For organizations already invested in OpenClaw infrastructure, this plugin offers the fastest path to enterprise-grade AI deployment within Feishu environments, with production-ready features like allowlist controls, media size limits, and flexible rendering modes that standalone solutions typically lack.

Conclusion

The clawdbot-feishu project represents a mature, enterprise-ready solution for organizations seeking to deploy AI agents within Feishu collaboration environments. Its combination of sophisticated workspace isolation, comprehensive resource access, and flexible configuration options make it an essential tool for teams building conversational AI experiences. The active community, professional codebase, and permissive MIT license position it as the definitive choice for Feishu-OpenClaw integration.