Feishu Channel Setup

Step-by-step guide to create a Feishu app and configure it as a channel in OpenClaw.

Open the Feishu Developer Console

1
Open the developer console

Visit https://open.feishu.cn/app and sign in with your Feishu account.

Create an App

2
Create a new enterprise app

Click 'Create Enterprise App', fill in the app name, description, and choose an icon.

Create a new enterprise app

Obtain App Credentials

3
Copy App ID and App Secret

On the 'Credentials & Basic Info' page, copy the App ID (format like `cli_xxx`) and App Secret. Keep the App Secret safe and do not share it.

Copy App ID and App Secret

Enable Bot Capability

4
Enable Bot

In 'App Capabilities' > 'Bot', enable the bot capability so the application can act as a robot in chats.

Enable Bot

Configure Permissions

5
Import required scopes

In 'Permission Management' click 'Bulk Import' and paste the JSON below to import the required tenant and user scopes. ```json { "scopes": { "tenant": [ "contact:contact.base:readonly", "aily:file:read", "aily:file:write", "application:application.app_message_stats.overview:readonly", "application:application:self_manage", "application:bot.menu:write", "cardkit:card:write", "contact:user.employee_id:readonly", "corehr:file:download", "docs:document.content:read", "event:ip_list", "im:chat", "im:chat.access_event.bot_p2p_chat:read", "im:chat.members:bot_access", "im:message", "im:message.group_at_msg:readonly", "im:message.group_msg", "im:message.p2p_msg:readonly", "im:message:readonly", "im:message:send_as_bot", "im:resource", "sheets:spreadsheet", "wiki:wiki:readonly" ], "user": [ "contact:contact.base:readonly", "aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read" ] } } ```

Import required scopes

Add Feishu Channel in OpenClaw

6
Add Channel

Log into your OpenClaw account, go to 'My OpenClaw' → 'Channels' and click '+ Add Channel'. Enter the Feishu App ID and App Secret you obtained, save and wait for the configuration to succeed.

Add Channel

Configure Event Subscription and Callbacks

7
Choose connection mode

Select 'Use long connection to receive events' (WebSocket mode). Note: OpenClaw must have the Feishu channel configured first or saving may fail.

Choose connection mode
8
Add message receive event

Add the event `im.message.receive_v1` to receive incoming messages.

Add message receive event

Publish the App

9
Publish

Fill in the version details and save, then publish the application so it becomes available to your tenant.

Publish

Chat with the bot

10
Send a message to the bot

From the Feishu Workbench, find the bot you created and send a message to start chatting with it.

Send a message to the bot