1.9.7.2 Configuring Feishu Bot

This chapter describes how to integrate OpenClaw with the Feishu bot, enabling interaction with the AI assistant through Feishu.

Creating a Feishu Application

Creating the Application

1. Log in to the Feishu Open Platform using your Feishu account.

2. Click Create Custom App.

   

3. Fill in the application name and description, select an application icon, and click the Create button.

   

4. Click Version Management & Release → Create a Version.

   

5. Fill in the version information and click the Save button.

   

Configuring Application Permissions

1. On the Permissions & Scopes page, click the Batch Import/export scopes button.

   

2. Paste the following JSON configuration to import the required permissions in one click:

   {
     "scopes": {
       "tenant": [
         "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": ["aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read"]
     }
   }

3. After importing the permissions, click Next, Review New Scopes, then click Add → Confirm to enable the permissions.

Enabling Bot Capabilities

1. Go to the Add Features > Bot page.

   

2. Enable bot capabilities, fill in the "Bot guide" information, and click the Save button.

   

Configuring OpenClaw

Obtaining Application Credentials

Note

Please keep the App Secret secure and do not share it with others.

On the application's Credentials & Basic Info page, copy:

• App ID
• App Secret

Configuring Application Credentials

1. Click Feishu Config in RDK Studio.

   

2. Enter the App ID and App Secret, and click the Save Config button.

   

Configuring Event Subscriptions

Note

If the gateway is not started or the channel is not added, the long connection settings will fail to save.

1. On the Events & Callbacks page, under the Event Configuration tab, select Receive events through persistent connection and click the Save button.

   

2. Click the Add Events button, enter im.message.receive_v1 in the search box to search for the message reception event, check it, and click the Add button.

   

3. The added event will appear in the Added Events list.

   

Publishing the Application

1. On the Version Management & Release page, open the previously created version and click Publish.

2. Wait for administrator approval. Enterprise self-built applications are usually approved automatically.

   

Pairing Authorization

1. Send any message to the bot in Feishu. By default, the bot will reply with a pairing code.

2. Click Feishu Config in RDK Studio, enter the pairing code, and click the Approve button.

   

3. Wait for the prompt indicating that Feishu pairing is complete. Once paired, restart and you can communicate via Feishu.