Skip to main content
Connect Feishu (飞书) or Lark to your LemonClaw instance. This guide works for both hosted Claw instances and self-hosted LemonClaw deployments, and uses WebSocket mode so no public callback URL is 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 LemonClaw WebUI, 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

Open the LemonClaw WebUI

  1. If you’re using hosted Claw, go to your Claw Dashboard and click Open WebUI
  2. If you’re self-hosting LemonClaw, open your own WebUI (for example http://your-ip:18789) and sign in with your token
  3. In the WebUI, navigate to Settings → Channels
  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 Channels settings of your LemonClaw WebUI:
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 your LemonClaw config
  • This usually means the App ID or App Secret is incorrect
  • Double-check the credentials in your dashboard