Feishu Integration

This guide is currently available in Chinese only. Read in Chinese →

Connect OpenClaw to Feishu (Lark) in ~5 minutes. Feishu's persistent connection event subscription means no public IP or webhook is required.

Prerequisite: OpenClaw must already be deployed and running. See Server Deployment Guide first.

Overview

  1. Install the Feishu plugin via your bot
  2. Create a Feishu app at open.feishu.cn
  3. Configure permissions and event subscriptions
  4. Pass credentials to OpenClaw
  5. Publish the app

Step 1: Install the Plugin

Chat with your OpenClaw bot:

Install the Feishu channel plugin: openclaw plugins install @m1heng-clawd/feishu

Step 2: Create a Feishu App

  1. Go to open.feishu.cn/app and create a new app
  2. In Credentials & Basic Info, copy the App ID and App Secret
  3. Under Add App Capabilities, add a Bot
  4. In Permission Management, enable:
    • contact:user.base:readonly
    • im:message
    • im:message.p2p_msg:readonly
    • im:message.group_at_msg:readonly
    • im:message:send_as_bot
    • im:resource

Step 3: Configure Credentials

Send your App ID and App Secret to your OpenClaw bot, or run manually:

openclaw config set channels.feishu.appId "cli_xxxxx"
openclaw config set channels.feishu.appSecret "your_app_secret"
openclaw config set channels.feishu.enabled true

Step 4: Configure Event Subscription

In Events & Callbacks, select "Use persistent connection to receive events", then add:

  • im.message.receive_v1 (required)
  • im.message.message_read_v1
  • im.chat.member.bot.added_v1
  • im.chat.member.bot.deleted_v1

Step 5: Publish & Test

Publish the app version, then message your bot in Feishu. For group chats, remember to @mention the bot.