Skip to main content
Connect Feishu (飞书) or Lark to your Claw instance. Uses WebSocket mode — no public callback URL needed.

​
Prerequisites

​
Setup Guide

1

Create a Feishu App

  1. Go to Feishu Open Platform (or Lark Developer)
  2. Click Create Custom App
  3. Enter an app name and description
  4. Click Create
2

Add Bot Capability

  1. In your app settings, go to Features → Bot
  2. Enable the bot capability
  3. This allows your app to receive and send messages
3

Get Credentials

  1. Go to Credentials & Basic Info
  2. Copy the App ID (starts with cli_)
  3. Copy the App Secret
4

Configure Event Subscription

  1. Go to Event Subscriptions
  2. Select WebSocket mode (recommended — no public URL needed)
  3. If prompted, set the Encrypt Key and Verification Token
When you configure Feishu in the LemonData dashboard, Encrypt Key and Verification Token are auto-generated for you. Copy these values into the Feishu developer console.
5

Add Event Permissions

  1. Under Event Subscriptions, add these events:
    • im.message.receive_v1 — Receive messages
  2. Go to Permissions & Scopes and add:
    • im:message — Send and receive messages
    • im:message.group_at_msg — Receive group @mentions
  3. Click Save
6

Publish the App

  1. Go to App Release → Version Management
  2. Create a new version
  3. Submit for review (for internal apps, this is usually instant)
  4. Once approved, the app is live
7

Configure in LemonData Dashboard

  1. Go to your Claw Dashboard
  2. Click the settings icon on your instance
  3. Open the IM Integrations tab
  4. Expand the Feishu section
  5. Paste your App ID and App Secret
  6. Copy the auto-generated Encrypt Key and Verification Token back to the Feishu developer console
  7. Click Save
8

Start Chatting

  1. In Feishu, search for your bot by name
  2. Send it a message
  3. The first user is automatically paired as the owner — no code needed!
  4. Start chatting with AI!

​
Group Settings

Configure group chat behavior in the IM Integrations tab of your Dashboard:
SettingOptionsDescription
Group PolicyOpen (default) / Allowlist / DisabledControls who can trigger the bot in groups
Require @mentionOn / OffBot only responds when @mentioned
Group IDsList of chat IDsRestrict to specific groups (empty = all groups)
Group Allowed UsersList of Open IDsOnly these users can trigger the bot (allowlist mode)

​
Troubleshooting

  • Verify the app is published and approved
  • Check that im.message.receive_v1 event is subscribed
  • Make sure WebSocket mode is selected (not HTTP)
  • Verify Encrypt Key and Verification Token match between Feishu console and Claw config
  • This usually means the App ID or App Secret is incorrect
  • Double-check the credentials in your dashboard