Clawdbot Feishu Integration Guide: A Fully Domestic Chinese Solution

Reposted from 歸藏 (@op7418)’s Twitter.

Clawdbot 2026.2.2 officially added Feishu (飞书) integration plugin support. This means users in China can use domestic AI models + Feishu without worrying about network issues—a fully localized AI assistant solution.

Feishu also supports group chats, enabling team-wide access.

For domestic model configuration, see: How to configure domestic models

Step 1: Create a Bot in Feishu Developer Console

Go to the Feishu Developer Console and create a new bot application. Fill in the app name, description, and choose a background color and icon.

After creation, note down two key pieces of information:

• App ID
• App Secret

Found under “Credentials & Basic Info - App Credentials.”

Configure Permissions

Go to Permission Management, find “Batch Import/Export Permissions,” and import the permission JSON. The Clawdbot official docs for Feishu have a ready-made JSON—just select all and import.

Click “Confirm New Permissions” to complete.

Enable Bot Capability

On the “Bot” configuration page, click “How to Get Started,” enter a welcome message (e.g., “Hello, I’m your AI assistant”), and save. Without this, the bot can’t receive messages.

Step 2: Configure Feishu Channel in Clawdbot

This part has several gotchas—pay attention to the key points.

Run the Setup Wizard

openclaw channels add

Select Feishu/Lark. The system will auto-download the plugin.

⚠️ Gotcha 1: If it says “plugin already exists” and jumps back to the menu, a previous installation failed. Manually delete the plugin folder from the directory shown, then re-run the command.

Fix Missing zod Dependency

During reinstallation, you may see a missing zod dependency error. This is a known bug.

Solution: Install zod globally:

npm install -g zod

Then re-run openclaw channels add and select Feishu.

Fill in Configuration

⚠️ Gotcha 2: You must select “Finished” after filling in—otherwise the channel isn’t actually added!

Configure DM Access Policy

• Configure DM access policies now? → Yes
• Feishu DM policy → Pairing (recommended, requires pairing code)
• Add display names? → No

Restart Gateway

openclaw gateway restart

Step 3: Final Configuration on Feishu Platform

Configure Event Subscription

Go to “Events & Callbacks” → “Event Configuration” → “Subscription Method,” select “Use Long Connection to Receive Events,” and save.

💡 If it warns “no long connection established,” wait 1-2 minutes and try saving again.

Add Message Receive Event

On the “Event Configuration” page, click “Add Event” and search for:

im.message.receive_v1

Without this event, the bot can’t receive messages.

Publish Version

Go to “Version Management & Publishing,” create a version and publish. Configuration won’t take effect without publishing.

Step 4: Pair the Bot

1. Find your bot in Feishu and send it a message
2. The bot replies with a pairing code: pair:XXXXXX
3. Copy the code and send it in the Clawdbot Web UI
4. Binding complete!

After binding, you can add the bot to group chats for team access.

Troubleshooting Summary

Combined with domestic AI models (minimax, kimi, GLM, etc.), the entire stack is fully localized.

Official docs: Clawdbot Feishu Configuration

Original author: 歸藏 (@op7418)