Feishu Integration¶

This document explains how to integrate OpenClaw with Feishu to enable conversations with OpenClaw directly in Feishu.

Creating a Feishu Application¶

Create an Enterprise Self-Built Application¶

Log in to the Feishu Open Platform.
Click Create Enterprise Self-Built Application.

Configure Application Information¶

Set the application name, description, and icon, then click Create to finish setup.

Add Bot Capability¶

In the left navigation tree, go to App Capabilities -> Add App Capabilities.
Select the By Capability tab.
Click Add on the Bot capability card.

Configure Permissions¶

Import Permission Configuration¶

In the left navigation tree, go to Development Configuration -> Permissions Management.
Click Batch Import/Export Permissions.
In the Import tab, paste the permission configuration code.
Click Next: Confirm New Permissions.
In the pop-up dialog, verify the permissions and click Apply.

Permission Configuration Code¶

Click to view permission configuration code

{
  "scopes": {
    "tenant": [
      "contact:contact.base:readonly",
      "docx:document:readonly",
      "im:chat:read",
      "im:chat:update",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message.pins:read",
      "im:message.pins:write_only",
      "im:message.reactions:read",
      "im:message.reactions:write_only",
      "im:message:readonly",
      "im:message:recall",
      "im:message:send_as_bot",
      "im:message:send_multi_users",
      "im:message:send_sys_msg",
      "im:message:update",
      "im:resource",
      "application:application:self_manage",
      "cardkit:card:write",
      "cardkit:card:read"
    ],
    "user": [
      "contact:user.employee_id:readonly",
      "offline_access",
      "base:app:copy",
      "base:field:create",
      "base:field:delete",
      "base:field:read",
      "base:field:update",
      "base:record:create",
      "base:record:delete",
      "base:record:retrieve",
      "base:record:update",
      "base:table:create",
      "base:table:delete",
      "base:table:read",
      "base:table:update",
      "base:view:read",
      "base:view:write_only",
      "base:app:create",
      "base:app:update",
      "base:app:read",
      "sheets:spreadsheet.meta:read",
      "sheets:spreadsheet:read",
      "sheets:spreadsheet:create",
      "sheets:spreadsheet:write_only",
      "docs:document:export",
      "docs:document.media:upload",
      "board:whiteboard:node:create",
      "board:whiteboard:node:read",
      "calendar:calendar:read",
      "calendar:calendar.event:create",
      "calendar:calendar.event:delete",
      "calendar:calendar.event:read",
      "calendar:calendar.event:reply",
      "calendar:calendar.event:update",
      "calendar:calendar.free_busy:read",
      "contact:contact.base:readonly",
      "contact:user.base:readonly",
      "contact:user:search",
      "docs:document.comment:create",
      "docs:document.comment:read",
      "docs:document.comment:update",
      "docs:document.media:download",
      "docs:document:copy",
      "docx:document:create",
      "docx:document:readonly",
      "docx:document:write_only",
      "drive:drive.metadata:readonly",
      "drive:file:download",
      "drive:file:upload",
      "im:chat.members:read",
      "im:chat:read",
      "im:message",
      "im:message.group_msg:get_as_user",
      "im:message.p2p_msg:get_as_user",
      "im:message:readonly",
      "search:docs:read",
      "search:message",
      "space:document:delete",
      "space:document:move",
      "space:document:retrieve",
      "task:comment:read",
      "task:comment:write",
      "task:task:read",
      "task:task:write",
      "task:task:writeonly",
      "task:tasklist:read",
      "task:tasklist:write",
      "wiki:node:copy",
      "wiki:node:create",
      "wiki:node:move",
      "wiki:node:read",
      "wiki:node:retrieve",
      "wiki:space:read",
      "wiki:space:retrieve",
      "wiki:space:write_only"
    ]
  }
}

For detailed meanings of these permissions, see the Feishu API Permission List.

Publish the Application¶

Create Version and Publish¶

Click Create Version at the top of the page.
Configure version number, default capabilities, and release notes as needed.
Click Save at the bottom of the page to create the version.
Click Confirm Publish in the top-right corner.

Get Configuration Information¶

In the left navigation tree, go to Basic Information -> Credentials & Basic Info.
In the App Credentials section, copy and record the App ID and App Secret.

Configure Event Subscription & Callback Long Connection¶

Caution

For bot applications without long connection enabled, you must start an OpenClaw instance after obtaining the App ID and App Secret in order to save event subscription and callback long connection settings. See the OpenClaw Quick Start guide.

Configure Event Subscription¶

Go to Event & Callback and set the event subscription mode to Long Connection.
Add message receiving events (other events can also be added as needed):

Configure Callback¶

Click Callback Configuration.
Select Long Connection as the configuration method.
Add a callback configuration.

Publish Version¶

Publish the version and wait for approval.

Start Conversation¶

Find your bot in Feishu and start chatting with OpenClaw!