OpenClaw: Complete 3‑Step Feishu Bot Integration (Fix Permissions & Event Subscription)

Prerequisites

OpenClaw must be installed and return a version with openclaw --version. A Feishu enterprise administrator account is required to create a custom application on the Feishu Open Platform.

Step 1 – Create a Feishu application

New custom app

Open open.feishu.cn, log in, and click “Create Custom App”.

Obtain credentials

On the “Credentials & Basic Info” page copy the App ID and App Secret . They are needed later when configuring OpenClaw.

Batch import permissions

Navigate to “Permission Management → Batch Import”, paste the following JSON, and confirm:

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

Enable bot capability

In the sidebar go to “App Features → Bot”, turn on the bot capability and set a bot name.

Configure event subscription

Open “Events & Callbacks → Event Subscription”. Choose the encryption strategy **Long Connection (WebSocket)** and add the event im.message.receive_v1. Missing this subscription is the most common cause of an unresponsive bot.

Publish the app

Create a version, fill the version number, select the availability scope, and click Publish. Personal‑edition custom apps go live immediately without review.

Step 2 – Configure OpenClaw

# Install the Feishu plugin
openclaw plugins install @openclaw/feishu

# Interactively add a Feishu channel; provide App ID and App Secret when prompted
openclaw channels add

Step 3 – Start and test

# Restart the gateway
openclaw gateway restart

Send any message to the bot in Feishu. The terminal will display a pairing code. Approve the pairing:

openclaw pairing approve feishu <pairing_code>

Send another message; receiving an AI reply confirms successful integration.

Common issues

Bot unresponsive : Verify that the event im.message.receive_v1 is subscribed and that “Long Connection” mode is selected.

duplicate plugin id detected : The Feishu plugin was loaded twice. Remove the duplicate directory and restart the gateway:

rm -rf ~/.openclaw/extensions/feishu
openclaw gateway restart

Cannot find module 'zod' : Install the missing module globally and restart the gateway:

npm install -g zod
openclaw gateway restart

Command cheat sheet

Install Feishu plugin: openclaw plugins install @openclaw/feishu Add Feishu channel: openclaw channels add Restart gateway: openclaw gateway restart Approve pairing: openclaw pairing approve feishu <pairing_code> Check gateway status: openclaw gateway status Follow live logs: openclaw logs --follow Typical failure points are the event subscription and the Feishu plugin configuration; following the steps above resolves them.

Related links:

OpenClaw website: https://openclaw.ai/

Feishu integration documentation: https://docs.openclaw.ai/zh-CN/channels/feishu

Feishu Open Platform: https://open.feishu.cn/app