Feishu/Lark integration - Elastic Desktop Service - Alibaba Cloud Documentation Center

Integrate your Agent with Feishu or Lark. Feishu supports Quick pairing (scan and go, no app setup required) and Link an existing bot. Lark supports Link an existing bot only.

Prerequisites

An Agent has been created in the Agent Management Center.

Channel configuration

Go to the Agent Management Center.
In the left-side navigation pane, select your Agent type, such as JVS Computer.
Click Channel Configuration.
In the Actions column of the target Agent, click View/Configure Channel.
On the Feishu card, click Configure Now.
Note
- For OpenClaw and JVS Computer Agents in regions outside the Chinese mainland, the Feishu card is labeled Feishu/Lark. You can select Feishu or Lark from the Channel Type drop-down list.
- For Chinese mainland regions and other Agent types, only Feishu is supported.

Feishu

Choose a method to integrate your Feishu bot:

Express Pairing

Note

The OpenClaw type is not supported. Use Associate Existing Robot instead.
Requires cloud computer image version: Windows 3.2.18 or later, or Linux 3.0.10 or later. Restart your cloud computer to update.

Click Send Now. The system sends an SMS or email with an access link to the authorized user.
The authorized user opens the binding page through the URL in the SMS or email to get a QR code. You can also obtain this URL directly in the console.
Use Feishu to scan the QR code to complete bot binding.

Note

If a bot is already bound, scanning the QR code replaces it.

Associate Existing Robot

Note

Your Feishu organization must have developer permissions. If not, contact your administrator to enable them.

Create a Feishu app

Go to the Feishu Open Platform and click Developer Console in the upper-right corner.
Click Create Custom App and fill in the required information.
On the Credentials & Basic Info page of your app, copy the App ID (in the format cli_xxx) and App Secret.

Configure app permissions

On the app details page in the Feishu Open Platform, click Permissions > Add Permissions, then click Bulk Import/Export Permissions.

Paste the following JSON configuration to import all required permissions at once, then click Next, Confirm New Permissions.

{
  "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"]
  }
}

In the dialog box, verify that the permissions are correct, then click Apply.

Configure events and publish the bot

On the App Features > Bot page, enable the bot and configure its name.
On the Event Subscriptions page, click Event Configuration > Subscription Method, select Use long connection to receive events, and save.
Click Add Events and add Receive Message (im.message.receive_v1).
Go to Version Management & Release > Create a version, fill in the required information, and click Save.

Enter credentials to complete linking

Go back to the Agent Management Center of the EDS console, enter the App ID and App Secret of your Feishu app, then click OK.

Pairing authorization

In Feishu, find the bot you bound and send it any message to trigger pairing.

The bot replies with a message that contains the Feishu user ID and a Pairing code, and prompts you to run the command openclaw pairing approve feishu <pairing_code> to approve it. Record the pairing code for the next step.
On the cloud computer terminal, run the following command to approve the pairing: openclaw pairing approve feishu <pairing_code>.
Run the following command to restart the OpenClaw service to apply the pairing authorization: openclaw gateway restart.

After the service restarts, you can chat with the bot in Feishu and let the Agent handle related tasks.

Lark

Note

Lark is available only for OpenClaw and JVS Computer Agents in regions outside the Chinese mainland.
Your Lark organization must have developer permissions. If not, contact your administrator to enable them.

Create a Lark app

Go to the Lark Open Platform and click Developer Console in the upper-right corner.
Click Create Custom App and fill in the required information.
On the Credentials & Basic Info page of your app, copy the App ID (in the format cli_xxx) and App Secret.

Configure app permissions

On the app details page in the Lark Open Platform, click Permissions > Add Permissions, then click Bulk Import/Export Permissions.

Paste the following JSON configuration to import all required permissions at once, then click Next, Confirm New Permissions.

{
  "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"]
  }
}

In the dialog box, verify that the permissions are correct, then click Apply.

Configure events and publish the bot

On the App Features > Bot page, enable the bot and configure its name.
On the Event Subscriptions page, click Event Configuration > Subscription Method, select Use long connection to receive events, and save.
Click Add Events and add Receive Message (im.message.receive_v1).
Go to Version Management & Release > Create a version, fill in the required information, and click Save.

Enter credentials to complete linking

Go back to the Agent Management Center of the EDS console, enter the App ID and App Secret of your Lark app, then click OK.

Pairing authorization

In Lark, find the bot you bound and send it any message to trigger pairing.

The bot replies with a message that contains the Lark user ID and a Pairing code, and prompts you to run the command openclaw pairing approve lark <pairing_code> to approve it. Record the pairing code for the next step.
On the cloud computer terminal, run the following command to approve the pairing: openclaw pairing approve lark <pairing_code>.
Run the following command to restart the OpenClaw service to apply the pairing authorization: openclaw gateway restart.

After the service restarts, you can chat with the bot in Lark and let the Agent handle related tasks.