Turn Feishu into an AI Assistant in 20 Minutes with OpenClaw

Prerequisites

OpenClaw installed and running

Feishu personal account (no admin required)

Step 1: Create an app in Feishu Open Platform

Open https://open.feishu.cn/app, log in, create an Enterprise Self‑Built App . Record the App ID and App Secret for later use.

App Secret is a password; keep it confidential.

Step 2: Configure permissions

In “Permission Management → Batch Import” paste the following JSON and confirm that all scopes are enabled.

{
  "scopes": {
    "tenant": [
      "contact:user.base:readonly",
      "contact:user.employee_id:readonly",
      "contact:user.id:readonly",
      "contact:contact.base:readonly",
      "im:chat",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:read",
      "im:chat.moderation:read",
      "im:chat.tabs:read",
      "im:chat.tabs:write_only",
      "im:chat.top_notice:write_only",
      "im:chat:moderation:write_only",
      "im:chat:operate_as_owner",
      "im:chat:read",
      "im:chat:readonly",
      "im:chat:update",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.group_msg",
      "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.urgent",
      "im:message.urgent.status:write",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:message:send_multi_depts",
      "im:message:send_multi_users",
      "im:message:send_sys_msg",
      "im:message:update",
      "im:resource",
      "im:url_preview.update",
      "im:user_agent:read",
      "passport:session_mask:readonly"
    ],
    "user": []
  }
}

Step 3: Configure event subscription

Enable “Use long connection to receive events” (WebSocket mode) under “Event & Callback”. This avoids the need for a public server or domain.

Step 4: Add Feishu channel in OpenClaw

Run the following commands in the terminal: openclaw channels add Select Yes, then choose Feishu . Enter the App ID and App Secret saved earlier, set region to China, channel to Open, enable pairing, and finally restart the gateway:

openclaw gateway restart

Step 5: Publish the app

In the Feishu console go to “Version Management & Release → Create Version”, fill a version number and release notes, then publish.

Step 6: Test the integration

Search the bot name in Feishu and send a message. The first connection returns a pairing code; approve it with:

openclaw pairing approve feishu <pairing_code>

After approval the bot replies, providing an AI programming assistant inside Feishu.

Common pitfalls

Forgot to enable "Use long connection to receive events" – messages won’t arrive.

Extra spaces when copying App ID or App Secret.

Did not publish the app version before testing.

Importing permissions via the JSON prevents missing scopes.

Troubleshooting

If the bot does not respond, verify the app is published, long‑connection is enabled, and all permissions are granted.

If sending messages fails, ensure the im:message:send_as_bot permission is enabled.

If the App Secret is compromised, reset it in the Feishu console and restart the gateway with openclaw gateway restart.

Reference URLs

OpenClaw documentation: https://docs.openclaw.ai

OpenClaw Feishu channel guide: https://docs.openclaw.ai/channels/feishu

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

API quota removal form: https://bytedance.larkoffice.com/share/base/form/shrcniy7Xzpp1dL75aOPtvEJTZd?from=navigation