Back to Guides

Connect Feishu to SetupClaw

Set up a Feishu bot powered by OpenClaw in minutes

Estimated time: 10-15 minutes

Prerequisites

  • SetupClaw APP installed and running
  • A Feishu workspace with admin access
  • OpenClaw configured with at least one AI model
1

Step 1: Create a Feishu App

Go to the Feishu Open Platform (open.feishu.cn) and create a new custom application.

  1. aVisit open.feishu.cn and log in with your Feishu account
  2. bClick "Create Custom App"
  3. cEnter an app name (e.g., "AI Assistant") and description
  4. dNote down the App ID and App Secret — you'll need these in SetupClaw
2

Step 2: Configure Bot Capabilities

Enable the bot feature for your Feishu app.

  1. aIn your app settings, go to "Add Features" → "Bot"
  2. bEnable the bot capability
  3. cSet the bot name and description that users will see in Feishu
3

Step 3: Set Permissions

Grant the necessary permissions for your bot to send and receive messages.

  1. aGo to "Permissions & Scopes"
  2. bAdd the following permissions: im:message (send messages), im:message.receive_v1 (receive messages), im:chat (access chat info)
  3. cRequest approval for these permissions if required by your organisation
4

Step 4: Configure Event Subscription

Set up the webhook URL so Feishu can send message events to OpenClaw.

  1. aGo to "Event Subscriptions"
  2. bEnable event subscriptions
  3. cThe Request URL will be provided by SetupClaw during setup — you'll enter it here later
  4. dSubscribe to the "Message Received" event (im.message.receive_v1)
5

Step 5: Enter Credentials in SetupClaw

Open SetupClaw APP and navigate to the Channels section.

  1. aOpen SetupClaw APP
  2. bGo to Channels → Add Channel → Select Feishu
  3. cEnter the App ID and App Secret from Step 1
  4. dClick Connect — SetupClaw will install the Feishu plugin automatically
  5. eThe gateway will reload with the new channel configuration
6

Step 6: Publish Your App

Make your Feishu bot available to users in your workspace.

  1. aBack in the Feishu Open Platform, go to "Version Management"
  2. bCreate a new version and submit for review
  3. cOnce approved, the bot will appear in your Feishu workspace
  4. dUsers can find and message the bot directly
7

Step 7: Pair Your Account

Send a message to your bot in Feishu to initiate pairing.

  1. aOpen Feishu and find your newly created bot
  2. bSend any message to the bot
  3. cThe bot will respond with a pairing code
  4. dEnter this code in SetupClaw APP to approve the pairing
  5. eYour Feishu bot is now connected and ready to use!

Advanced: Multi-Bot Setup

SetupClaw supports multiple Feishu bots, each with its own AI agent and workspace. To add another bot, go to Channels → Feishu → Add Bot, and repeat Steps 1-7 with a new Feishu app. Each bot operates independently with its own conversation history.

Troubleshooting

Back to Guides