Integrate Feishu¶

This document explains how to integrate OpenClaw with Feishu so you can interact with OpenClaw directly through Feishu.

Create a Feishu App¶

Create an Internal Enterprise App¶

Log in to the Feishu Open Platform.
Click the Create Internal App button.

Configure App Information¶

Set the App name, description, and icon, then click Create to complete the creation.

Add Bot Capability¶

In the left navigation tree, select App Capabilities → Add Capabilities .
Select the Add by Capability tab.
Click Add on the Bot capability card.

Configure Permissions¶

Import Permission Configuration¶

In the left navigation tree, select Development Configuration → Permission Management .
Click Batch Import/Export Permissions .
In the Import tab, paste the permission configuration code.
Click Next: Confirm New Permissions .
In the popup window, confirm the permissions and click Apply .

Permission Configuration Code¶

Click to view the 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",
      "App:App: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 explanations of these permissions, see the Feishu API Scope List.

Publish the App¶

Create a Version and Publish¶

Click the Create Version button at the top.
Configure the App 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 upper-right corner to publish the App.

Obtain Credentials¶

In the left navigation tree, select Basic Information → Credentials & Basic Info .
In the App Credentials section, obtain and record the App ID and App Secret .

Configure Event Subscriptions and Callback Long Connection¶

Caution

For bot Apps that have not yet configured a long connection, you must start an OpenClaw instance after obtaining the App ID and App Secret before saving the event subscription and callback long-connection configuration.

Refer to the OpenClaw Quick Start guide to start an OpenClaw instance.

Configure Event Subscription¶

Click Events & Callbacks in the left navigation and set Event Subscription to Long Connection.
Add a Message Receive Event (other events can be added as needed).

Configure Callback¶

Click Callback Configuration.
Set the configuration method to Long Connection.
Add a callback configuration.

Publish the Version¶

Publish the version and wait for approval.

Start Chatting¶

Find your bot in Feishu and start chatting!