OpenClaw Feishu/Lark Integration: ByteDance Enterprise Messaging Setup

What Is Feishu/Lark?

Feishu (飞书) is ByteDance's enterprise communication and collaboration platform. If you have heard of Lark — it is the same product. Feishu is the name used in mainland China, while Lark is the international brand. ByteDance (the company behind TikTok and Douyin) built Feishu originally for its own internal use and then released it as a commercial product.

Feishu combines messaging, video conferencing, document collaboration, project management, and workflow automation in a single platform. Think of it as Slack, Zoom, Google Docs, and Notion combined into one app. It is used by hundreds of thousands of companies across Asia, with particular strength in China, Japan, Singapore, and Southeast Asia.

For OpenClaw operators, Feishu matters because it is one of the most capable enterprise messaging platforms for bot development. The Feishu Open Platform provides comprehensive APIs for creating custom applications, handling messages, managing users, and integrating with Feishu's suite of productivity tools. Unlike personal WeChat, where bot integration exists in a gray area, Feishu actively encourages and supports bot development.

The platform has grown rapidly since 2023, and as of early 2026, Feishu/Lark has become the default enterprise communication tool for a significant portion of the Chinese tech industry and is expanding aggressively in Southeast Asia, Japan, and India.

Why Feishu for OpenClaw?

There are several compelling reasons to connect OpenClaw to Feishu rather than (or in addition to) other messaging platforms:

• Official bot support: Feishu provides first-class APIs for bot development. Your OpenClaw bot is a sanctioned, official application — not a workaround or gray-area integration. This means reliable connections, no risk of account bans, and access to the full range of messaging features.
• Rich message formats: Feishu supports text, rich text cards, interactive buttons, images, files, and custom message templates. Your OpenClaw agent can send structured, visually appealing responses — not just plain text. Interactive cards let users take actions directly from the message, like approving a request or selecting an option.
• Group and individual messaging: A single Feishu bot can handle both direct messages and group conversations. In a group context, users can mention the bot to trigger responses. This allows a single OpenClaw agent to serve an entire team through one Feishu group.
• Deep platform integration: Through the Feishu API, your OpenClaw agent can also interact with Feishu Docs, Feishu Sheets, Feishu Calendar, and Feishu Approval workflows. This means your agent can create documents, update spreadsheets, check calendar availability, and trigger approval processes — all within the Feishu ecosystem.
• Growing user base: If your clients, partners, or team members use Feishu, connecting OpenClaw to Feishu means your AI agent reaches them where they already work. No context switching, no asking people to install a new app.

Feishu Open Platform Setup

The Feishu Open Platform (open.feishu.cn for China, open.larksuite.com for international) is where you create and manage custom applications. Here is how to get started:

Step 1: Create an enterprise account. If your organization does not have a Feishu/Lark enterprise account, create one. Enterprise accounts are free and include access to the Open Platform. You will need to verify your organization during the registration process.

Step 2: Access the Open Platform. Log in to the Feishu Open Platform developer console. This is separate from the regular Feishu app — it is the developer portal where you manage custom applications, bots, and integrations.

Step 3: Create a custom application. Click "Create Custom App" in the developer console. Choose "Enterprise Self-built App" as the application type. Give your app a name (for example, "OpenClaw Assistant"), description, and icon. This is the identity your bot will have when it messages users.

Step 4: Configure permissions. Your application needs specific permissions to function as an OpenClaw bridge. At minimum, enable: "Read and send messages as bot," "Read user information," and "Access group chat information." If you want your agent to interact with Feishu Docs or Calendar, enable those permissions as well.

Step 5: Record your credentials. Note the App ID and App Secret from the application's credentials page. You will also need the Verification Token and Encrypt Key from the Event Configuration page. These are used to authenticate the connection between Feishu and your OpenClaw server.

Creating Your Feishu Bot

With your application created, the next step is enabling bot functionality:

Enable the bot capability: In your application's settings, navigate to "Features" and enable "Bot." This adds bot capabilities to your application, allowing it to send and receive messages in direct chats and group conversations.

Configure the bot's behavior: Set whether the bot should appear in the user's contact list, whether it can be added to groups, and whether it should receive all group messages or only those where it is mentioned. For most OpenClaw use cases, configure the bot to receive all messages in direct chats and only mentioned messages in groups.

Publish the bot: After configuration, publish your application within your Feishu enterprise. This makes the bot available to members of your organization. For testing, you can limit availability to specific users or departments before rolling out to the entire organization.

Add the bot to conversations: Once published, users in your organization can find the bot in their contacts and start direct conversations. You or other admins can add the bot to group chats where you want it to be available.

Webhook Configuration

The webhook connection is how Feishu delivers incoming messages to your OpenClaw server. When someone sends a message to your bot, Feishu sends an HTTP POST request to your configured webhook URL with the message details.

Set the request URL: In your application's Event Configuration, set the Request URL to your OpenClaw server's Feishu webhook endpoint. This is typically something like https://your-server.com/webhook/feishu. Your server must be publicly accessible via HTTPS.

Handle the verification challenge: When you first set the URL, Feishu sends a verification request to confirm your server is listening. Your OpenClaw Feishu plugin handles this automatically — it responds with the challenge token that Feishu expects.

Subscribe to events: Enable the events you want to receive. For messaging, subscribe to "Message received" events. For interactive card actions, subscribe to "Card action triggered" events. Each event subscription corresponds to a type of user interaction your agent can respond to.

Verify message signatures: For security, Feishu signs each webhook request using your Encrypt Key. The OpenClaw Feishu plugin verifies these signatures to ensure incoming messages are genuinely from Feishu and not from a malicious third party.

Message Handling and Responses

Once the webhook connection is established, the message flow works as follows:

1. A user sends a message to your bot (or mentions it in a group)
2. Feishu sends the message to your OpenClaw server via the webhook
3. OpenClaw processes the message through its AI pipeline — the message goes to your configured model (Claude, GPT, Qwen, etc.), the model generates a response, and any tool calls (email, calendar, etc.) are executed
4. OpenClaw sends the response back to Feishu via the Feishu API
5. The user sees the response in their Feishu conversation

This process happens in seconds for most interactions. The OpenClaw Feishu plugin handles message format conversion, ensuring that rich text, images, and files are properly formatted for Feishu's message types.

For group conversations, the plugin includes context about who sent the message, which group it came from, and any thread context. This allows your OpenClaw agent to maintain separate conversation contexts for different users and groups, even though they all flow through the same bot.

Status Reactions (New in 3.22)

OpenClaw 3.22 introduced Status Reactions support for Feishu (referenced in GitHub issue #53887). This feature allows your OpenClaw agent to react to messages with status indicators — visual cues that show users what is happening with their request.

In practice, this works like emoji reactions but with semantic meaning:

• When a message is received, the agent adds a "processing" reaction to show it has been acknowledged
• When the action is complete, the reaction changes to a "done" indicator
• If an error occurs, the reaction changes to an "error" indicator

This is particularly valuable in enterprise settings where users need feedback that their request was received and is being handled. Without status reactions, users see their message disappear into the void and have to wait for a text response to know anything happened. With reactions, they get immediate visual confirmation.

Status reactions are especially useful for long-running tasks. If you ask your OpenClaw agent to generate a report that takes 30 seconds, the "processing" reaction tells you immediately that the request was received and work is underway. Without it, you might think the bot is unresponsive and send the request again.

Enterprise Use Cases

Feishu's enterprise features make it particularly well-suited for team-wide OpenClaw deployments. Here are the most common enterprise use cases:

Team AI assistant: Deploy your OpenClaw agent as a shared team resource in a Feishu group. Team members can ask questions, request actions, and get information — all in the same group chat. The agent maintains context about each team member and the team's shared projects.

Meeting management: Integrate with Feishu Calendar to let your OpenClaw agent schedule meetings, check availability across team members, send agendas before meetings, and distribute action items afterward. Team members request these actions through natural language in Feishu chat.

Document automation: Connect OpenClaw to Feishu Docs and Sheets to automate document creation. Ask your agent to create a project brief, and it generates a Feishu Doc with the standard template filled in. Ask for a weekly report, and it compiles data from multiple sources into a Feishu Sheet.

Approval workflows: Feishu has built-in approval workflows. Your OpenClaw agent can initiate approvals, notify approvers, and track approval status. For example, when a deal closes in your CRM, the agent can automatically create a project approval request in Feishu and notify the relevant stakeholders.

Customer support triage: For teams that handle customer support through Feishu groups, the OpenClaw agent can monitor incoming requests, categorize them by urgency, draft initial responses, and escalate high-priority issues to the right team member.

Cross-platform orchestration: Because OpenClaw connects to multiple platforms simultaneously, your Feishu-based agent can take actions across your entire tool stack. A team member asks in Feishu: "Create a project for the Acme deal." The agent creates a Notion project page, a Slack channel, a Google Drive folder, and a Feishu group — all from one message.