OpenClaw Setup (III): Connect a Feishu Bot

Extend OpenClaw into Feishu by enabling the plugin, creating an app, importing permissions, and configuring event subscriptions.

Haoming Wang · Published March 17, 2026

Overview

Once the local installation is working, the most direct way to extend the same OpenClaw setup into mobile and group-chat scenarios is to connect it to a Feishu bot. This post walks through the full path: enabling the local plugin, creating the app on the Feishu Open Platform, importing permissions, subscribing to events, and publishing the app.

OpenClaw × ECNU AI Setup Series
① Retrieve ECNU AI API credentials
② Install OpenClaw and connect it to the model
③ Connect a Feishu bot (this post)

View the series overview

The goal here is not to explore advanced Feishu features. The goal is to complete the most basic, reproducible integration path and get the bot running reliably.

---

Enable the Feishu plugin

Step 1: Enable the plugin and confirm its status

First, enable the Feishu plugin in the terminal:

openclaw plugins enable feishu

Then verify the plugin status:

openclaw plugins list

If the feishu entry shows loaded, the plugin is ready to use.

Figure 1. Enable the Feishu plugin and confirm in plugins list that its status is loaded.

---

Create the Feishu app and record credentials

Step 2-4: Create an internal app and record its credentials

Open open.feishu.cn, go to the Feishu Open Platform, and click Create Internal App from the internal-app page.

Figure 2. Open the internal-app page and click Create Internal App.

Next, fill in the application name and description, then create the app.

Figure 3. Enter the app name and description, then create the app.

After the app is created, open Credentials & Basic Information and record both the App ID and the App Secret. You will need these values immediately in the terminal.

Figure 4. Record the App ID and App Secret from the credentials page.

---

Return to the terminal and finish the local connection

Step 5-8: Start channel setup and complete the local connection

Go back to the terminal and start the Feishu channel setup:

openclaw channels add

At the prompt Configure chat channels now?, choose Yes.

Figure 5. Run openclaw channels add and choose Yes when asked whether to configure chat channels now.

Then enter the App Secret and App ID you recorded earlier, and continue through the connection settings. Here, Figure 6, Figure 7, and Figure 8 each contain multiple annotated steps within a single screen, so follow the numbered order shown in the screenshots.

1. Choose Enter App Secret as the credential input method
2. Paste the App Secret and then the App ID
3. Set the connection mode to WebSocket, choose the mainland-China domain option, and select the group-chat policy
4. Keep the remaining options at their recommended defaults until Channels updated. appears

Recommended values for the connection settings:

Option	Recommended value	Note
Connection mode	WebSocket	Matches the setup in this post
Domain	feishu/feishu-China	Intended for mainland China
Group chat policy	open	Allows the bot to respond when used in group chats

Figure 6. Choose Enter App Secret, then continue within the same screen to paste the App Secret and App ID.

Figure 7. On the same screen, set the connection mode to WebSocket, choose the mainland-China domain, and select the group-chat policy.

Figure 8. Continue through the DM access, display-name, and agent-binding prompts until Channels updated. appears.

---

Add capabilities and permissions in Feishu

Step 9-11: Enable the bot capability and import the permissions JSON

Back on the Feishu Open Platform, first enable the bot capability for the app, then import the required permissions.

Figure 9. Open Add App Capability and enable the bot capability for the app.

Next, open Permission Management and select Batch Import/Export Permissions.

Figure 10. Open Permission Management and choose Batch Import/Export Permissions.

Paste the following JSON into the import dialog, or download the file directly and import it there: openclaw-feishu-permissions.json

Permissions JSON — This is the permission set required to run the Feishu bot configuration in this tutorial.

{
  "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:read",
      "cardkit:card:write",
      "contact:user.employee_id:readonly",
      "corehr:file:download",
      "event:ip_list",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:bot_access",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource"
    ],
    "user": [
      "aily:file:read",
      "aily:file:write",
      "im:chat.access_event.bot_p2p_chat:read"
    ]
  }
}

Figure 11. Paste the JSON into the import window and continue to confirm the newly requested permissions.

---

Configure events and publish the app

Step 12-13: Enable event subscriptions and publish the app

After the permission import is complete, open Events and Callbacks, choose Receive events via long connection (WebSocket), save the setting, and add the following four event subscriptions:

• im.message.receive_v1
• im.message.message_read_v1
• im.chat.member.bot.added_v1
• im.chat.member.bot.deleted_v1

Figure 12. Enable WebSocket event delivery on the Events and Callbacks page and add the four required events.

Finally, open Version Management & Release, fill in the version number, default capability, and release notes, and publish the app.

Figure 13. Complete the version number and release notes on the publishing page, then publish the app.

---

Outcome

At this stage, OpenClaw is no longer limited to the local terminal. The same model setup has been extended into the Feishu environment.

Completed:
1. Enabled the Feishu plugin locally and created the channel
2. Created the Feishu app and imported its required permissions
3. Published the app and enabled WebSocket event subscriptions

You can now add the bot to a Feishu group or use it in the supported scenarios directly. The same ECNU AI endpoint can now serve both the terminal workflow and the Feishu bot workflow.