Official documentation reference: https://docs.openclaw.ai/zh-CN/channels/feishu

What is OpenClaw Feishu Channel?

OpenClaw Feishu Channel is a way for OpenClaw to integrate with the Feishu (Lark) platform, allowing users to interact with OpenClaw through natural language via Feishu. By configuring the Feishu channel, users can send messages to OpenClaw in Feishu. OpenClaw will understand the user's intent and execute corresponding actions, then feedback the results to the user.

How to Configure OpenClaw Feishu Channel?

To configure OpenClaw Feishu Channel, users need to follow these steps:

1. Create a Feishu app: First, users need to create a new app on the Feishu Developer Platform and obtain the App ID and App Secret.
2. Configure permissions: In the Feishu app's permission settings, ensure that the app is granted necessary permissions so that it can receive messages and communicate with OpenClaw.
3. Get Webhook URL: In the Feishu app's settings, obtain the Webhook URL. This URL will be used for communication between OpenClaw and Feishu.
4. Configure OpenClaw: In OpenClaw's settings interface, enter the Feishu app's App ID, App Secret, and Webhook URL, and save the configuration.
5. Test connection: After configuration, users can verify the Feishu channel connection through OpenClaw's test function and ensure that OpenClaw can correctly receive messages from Feishu and process them.

Feishu Channel Configuration Example

Create Feishu App

1. Go to Feishu Developer Platform, register and log in, and enter the Developer Console:

2. Create a new app:

3. Fill in the related information:

Add Bot

Select Add app capabilities -> Add by capability -> Bot -> Add:

Grant Related Permissions

On the permissions management page, click Batch import/export permissions, select Import permissions, copy and paste the following permission list into the text box, then click Import permissions:

{
	"scopes": {
		"tenant": [
			"aily:file:read",
			"aily:file:write",
			"application:application.app_message_stats.overview:readonly",
			"application:application:self_manage",
			"application:bot.menu:write",
			"cardkit:card:write",
			"contact:user.employee_id:readonly",
			"corehr:file:download",
			"docs:document.content:read",
			"event:ip_list",
			"im:chat",
			"im:chat.access_event.bot_p2p_chat:read",
			"im:chat.members:bot_access",
			"im:message",
			"im:message.group_at_msg:readonly",
			"im:message.group_msg",
			"im:message.p2p_msg:readonly",
			"im:message:readonly",
			"im:message:send_as_bot",
			"im:resource",
			"sheets:spreadsheet",
			"wiki:wiki:readonly"
		],
		"user": ["aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read"]
	}
}

Create Initial Version

We will make modifications later. First, publish one, then we can configure event subscription.

Fill in anything casually, save and publish:

Add Channel for OpenClaw

Go to the Feishu bot's Credentials and Basic Information page, copy the App credentials. We will use them later:

Enter OpenClaw's settings interface:

openclaw configure

Use Up/Down arrow keys to select Local, then press Enter:

◆  Where will the Gateway run?
│  ● Local (this machine) (Gateway reachable (ws://127.0.0.1:18789))
│  ○ Remote (info-only)
└

Use Down arrow key to select Channels, press Enter:

◆  Select sections to configure
│  ○ Workspace
│  ○ Model
│  ○ Web tools
│  ○ Gateway
│  ○ Daemon
│  ● Channels (Link WhatsApp/Telegram/etc and defaults)
│  ○ Skills
│  ○ Health check
│  ○ Continue
└

Use Down arrow key to select Configure/link, press Enter:

To configure

◆  Channels
│  ● Configure/link (Add/update channels; disable unselected accounts)
│  ○ Remove channel config
└

Use Down arrow key to select Feishu/Lark, press Enter:

◆  Select a channel
│  ○ Telegram (Bot API)
│  ○ WhatsApp (QR link)
│  ○ Discord (Bot API)
│  ○ IRC (Server + Nick)
│  ○ Google Chat (Chat API)
│  ○ Slack (Socket Mode)
│  ○ Signal (signal-cli)
│  ○ iMessage (imsg)
│  ● Feishu/Lark (plugin · install)
│  ○ Nostr (NIP-04 DMs)
│  ○ Microsoft Teams (Bot Framework)
│  ○ Mattermost (plugin)
│  ○ Nextcloud Talk (self-hosted)
│  ○ Matrix (plugin)
│  ○ BlueBubbles (macOS app)
│  ○ LINE (Messaging API)
│  ○ Zalo (Bot API)
│  ○ Zalo (Personal Account)
│  ○ Synology Chat (Webhook)
│  ○ Tlon (Urbit)
│  ○ Finished
└

For installation mode, select npm installation. Use Down arrow key to select Download from npm, press Enter:

◆  Install Feishu plugin?
│  ● Download from npm (@openclaw/feishu)
│  ○ Skip for now
└

Enter the Feishu app's App ID and App Secret:

◆  Enter Feishu App ID
│  cli_a90f*****89cd9
└

◆  Enter Feishu App Secret
│  DAViZXBY*****fMyCV*****nC3Y
└

Select China site (Feishu (feishu.cn) - China), press Enter:

◆  Which Feishu domain?
│  ● Feishu (feishu.cn) - China
│  ○ Lark (larksuite.com) - International
└

Select open response:

◆  Group chat policy
│  ○ Allowlist - only respond in specific groups
│  ● Open - respond in all groups (requires mention)
│  ○ Disabled - don't respond in groups
└

Select Finished, press Enter:

◆  Select a channel
....
│  ● Finished (Done)
└

Use left/right arrow keys to select Yes, press Enter:

◆  Configure DM access policies now? (default: pairing)
│  ● Yes / ○ No
└

Select Pairing:

◆  Feishu DM policy
│  ● Pairing (recommended)
│  ○ Allowlist (specific users only)
│  ○ Open (public inbound DMs)
│  ○ Disabled (ignore DMs)
└

Finally select Continue, press Enter:

◆  Select sections to configure
│  ○ Workspace
│  ○ Model
│  ○ Web tools
│  ○ Gateway
│  ○ Daemon
│  ○ Channels
│  ○ Skills
│  ○ Health check
│  ● Continue (Done)
└

Configure Event Subscription

On the Event Subscription page:

1. Select Use long connection to receive events (WebSocket mode)
2. Add event: im.message.receive_v1 (Receive messages)

⚠️ Note: If the gateway is not started or the channel is not added, the long connection settings will fail to save.

Publish New Version

On the Version Management and Release page:

1. Select Create Version
2. Fill in Version Number and Description
3. Scroll to the bottom of the page, click Save, then Confirm Release

We will receive a reminder in the Feishu interface. Click Open App to enter the chat interface.

Pairing

After opening the chat interface, send any message. The bot will reply with a pairing code. We need to use this pairing code for pairing:

Manually run this command:

Feishu Test

In the chat interface, send a message to the bot for testing:

Who are you? What model are you using? Check what is the name of the device currently running?