Better Feishu for OpenClaw: Enhanced Agent Integration

Enhanced Feishu Integration for OpenClaw Agents

Better Feishu for OpenClaw is a production-grade plugin that extends OpenClaw's native Feishu/Lark channel support with advanced message formatting, comprehensive API access, and intelligent contact management. Built for agents operating in Feishu-first organizations, it bridges the gap between OpenClaw's agent framework and Feishu's rich messaging and collaboration features.

Core Features

Intelligent Message Formatting

• Short messages (≤2000 chars): Native Markdown support with tag:md rich text format, including code blocks, tables, and formatted lists
• Long messages (>2000 chars): Automatic conversion to card format prevents message truncation in Feishu's UI
• Topic replies: Agents can respond within discussion threads, maintaining conversation context

Passive Observe Mode

• Agents receive all group messages (not just @mentions) with a configurable prefix for unaddressed messages
• Selective response logic: agents return NO_REPLY to skip responding to overheard conversations
• Behavior rules defined in workspace SOUL.md, giving non-technical users control over agent engagement patterns

Feishu API Integration

• Emoji reactions: Add or remove 50+ emoji responses (THUMBSUP, SMILE, etc.) on messages
• Member mentions: @ mention group members in responses (excluding other bots)
• File handling: Send local images and documents as attachments; auto-download and read incoming files
• Message management: Pin important messages, modify or delete prior messages
• Group operations: Query member lists, group info, and metadata
• Document & spreadsheet operations: Create, read, append to docs; manage permissions and edit sheets

Contact & Group Classification

• Automatic sender identification from message metadata, linked to agent's USER.md contact records
• Group tagging system ("work" vs "friends") to adjust agent response tone per conversation type
• Built-in USER.md template for structured contact and group metadata storage

Who Should Use This

• OpenClaw agents deployed in Feishu workspaces: Teams using Feishu as primary communication layer need richer formatting and API access than basic integrations provide
• Multi-channel operations: Organizations running agents across Feishu, Slack, and internal systems benefit from unified message handling
• Document-heavy workflows: Agents managing shared documents, spreadsheets, or collaborative knowledge bases
• Context-aware agents: Systems requiring message history, member awareness, and selective response logic

Getting Started

Installation requires three parallel tracks: agent-driven setup, user-provided Feishu credentials, and workspace template integration.

Prerequisites: OpenClaw 2026.2.4+, Feishu Open Platform account with permission to create enterprise apps, existing Feishu plugin backup support (automatic rollback available).

Quick path: Clone the repository, run the installation script (which auto-backs up existing Feishu plugin), configure your Feishu app in the Open Platform dashboard (enable WebSocket events, set permissions), provide App ID and Secret to OpenClaw, merge workspace templates into your SOUL.md/AGENTS.md files, and restart the gateway.

Detailed step-by-step guidance is provided in the repo's README for both agent operators and end users managing plugin configuration.

Configuration & Customization

The plugin ships with sensible defaults: private messages open to all users, group responses requiring bot mention, passive observe mode enabled. Override via openclaw.json:

• dmPolicy: open or restricted for direct messages
• groupPolicy: open or mention-only for group participation
• requireMention: Boolean to enforce @bot mentions in groups
• passiveObserve: Enable/disable overhearing group conversations

Workspace templates are merged (never overwritten) into existing files, so customizations survive plugin updates.

Resources

• GitHub Repository — Full source, installation scripts, and templates
• Feishu Open Platform — App creation and credential management
• openclaw-plugin-development — Learn to extend OpenClaw with custom plugins
• openclaw-agents — Explore OpenClaw agent frameworks

Created by: @QianruTian | Maintained for OpenClaw 2026.2.4+