Feishu Setup Guide
Complete guide to running OpenClaw AI assistant on Feishu
Prerequisites
Before starting, you need a Feishu account and access to Feishu Open Platform. Individual users can use 'Self-Built App' mode.
Step 1: Create Feishu App
Go to Feishu Open Platform (open.feishu.cn), log in, and go to Developer Console. Click 'Create Enterprise Self-Built App'.
- Fill in app name (e.g., My AI Assistant)
- Fill in app description (optional)
- Upload app icon (optional)
- Select your enterprise workspace
Screenshot
Step 2: Get Credentials
In the app page, find 'Credentials & Basic Info', copy these values:
Screenshot
Step 3: Configure Permissions
Click 'Permissions Management' on the left, add these permissions:
- im:message - Send and receive messages
- im:message.group_at_msg - Receive group @ messages
- im:message.receive_v1 - Receive message events
Screenshot
Step 4: Publish App
After configuring permissions, you need to create a version and publish:
- Click 'Create Version'
- Fill in version number (e.g., 1.0.0)
- Fill in update notes
- Click 'Save', then 'Publish'
Screenshot
Step 5: Configure in OpenClaw
Open OpenClaw Desktop, go to 'Channels' settings, select 'Feishu', paste App ID and App Secret from Step 2.
💡 We recommend 'Polling Mode' - simple and stable, no webhook setup needed.
Screenshot
Step 6: Test
Find your bot in Feishu and send a message. If configured correctly, AI will respond!
Screenshot
⚠️ Step 6: Test - Find your bot in Feishu and send a message. If configured correctly, AI will respond!
FAQ
Error: 'App Secret incorrect'
Go back to Feishu Open Platform and re-copy App Secret. Make sure there are no spaces. If still not working, try regenerating.
Bot not responding
1. Confirm app is published; 2. Confirm bot is added as contact; 3. Check if OpenClaw is running.
How to get API key?
Check the 'Free APIs' page - major Chinese providers offer free quotas.