This plugin integrates OpenClaw with Feishu/Lark, enabling bot functionalities within the Feishu/Lark ecosystem. It targets OpenClaw users seeking to leverage Feishu/Lark for automated workflows, AI interactions, and access to Feishu's integrated tools, offering a robust bridge between these platforms.

How It Works

The plugin functions as an OpenClaw channel, supporting both WebSocket (recommended) and Webhook connection modes for event handling. It processes direct messages (DMs) and group chats, offering granular control over access policies, mention requirements, and message rendering. Core functionality is powered by extensive Feishu API integrations, allowing the bot to interact with Feishu Documents, Drive, Wiki, Bitable, and Tasks, alongside standard messaging capabilities. Dynamic agent creation provides per-user workspace isolation for DMs.

Quick Start & Requirements

• Primary install: openclaw plugins install @m1heng-clawd/feishu
• Prerequisites: OpenClaw installation, a Feishu Open Platform application with configured App ID, App Secret, necessary API permissions (e.g., im:message, drive:drive:readonly), and event subscriptions (im.message.receive_v1).
• Windows Troubleshooting: Manual installation via npm pack or downloading tarballs is documented if the standard install fails.
• Links:
  • npm package versions: https://www.npmjs.com/package/@m1heng-clawd/feishu?activeTab=versions

Highlighted Details

• Supports WebSocket (default, no public URL needed) and Webhook connection modes.
• Offers flexible DM policies (pairing, open, allowlist) and group chat controls (requireMention, groupCommandMentionBypass).
• Integrates deeply with Feishu tools including Docs, Drive, Wiki, Bitable, and Tasks via comprehensive API scopes.
• Features dynamic agent creation for isolated user workspaces in DMs and @mention forwarding in replies.
• Handles inbound media (images, files) and outbound uploads, with configurable media size limits.

Maintenance & Community

The project acknowledges sponsors and suggests third-party API platforms. Community interaction is directed towards GitHub Discussions, Issues, and a CONTRIBUTING.md file, with no direct links to chat platforms like Discord or Slack provided.

Licensing & Compatibility

• License: MIT.
• Compatibility: Designed for OpenClaw. The MIT license generally permits commercial use and integration into closed-source projects, though specific terms should be reviewed.

Limitations & Caveats

Feishu API limitations necessitate specific configurations: Drive/Bitable resources must be shared with the bot, and bots require explicit addition to Wiki spaces. The bot must own a group chat to delete it. Subtask creation is limited to tasks initiated by the bot. Due to Feishu API rate limits, message streaming is not supported, opting for a complete-then-send approach. Certain sensitive permissions like im:message.group_msg are required for advanced group chat features.