Feishu (Lark) Integration Guide for OpenClaw

Who This Is For

Teams that want OpenClaw inside their daily collaboration hub
Environments where Feishu (Lark) is the primary workspace
Anyone ready to validate "receive message → process → reply" first

Install the Feishu Plugin

With OpenClaw already installed:

openclaw plugins install @openclaw/feishu

Then add the Feishu channel:

openclaw channels add

Select Feishu and enter your App ID and App Secret.

Setup Steps

1. Create an app on Feishu Open Platform

Go to open.feishu.cn and create a new app. Start with a minimal test app—do not configure many bots yet.

2. Configure permissions

Grant only what you need for testing. Common scopes include:

im:message — send and receive messages
docs:doc — read and write cloud docs
sheets:spreadsheet — read and write spreadsheets
im:message.receive_v1 — receive message events

Check the Feishu Open Platform docs for current scope names and details.

3. Configure event subscription

In the Feishu app settings:

Add event im.message.receive_v1 (receiving messages)
Choose WebSocket for event delivery
Ensure the OpenClaw gateway is running: openclaw gateway status

4. Publish the version

Feishu apps must be published before changes take effect. Many issues come from missing this step—the app looks configured but the bot never actually activates.

5. Finish OpenClaw config

Add only one minimal channel config first. Do not wire multiple bots, groups, or skills at once. Validate the basic loop before expanding.

Plugin Capabilities

The @openclaw/feishu plugin enables:

Messaging — read, send, search messages; download attachments
Cloud docs — create, read, and write Feishu documents
Spreadsheets — create and manage data tables
Calendar — view schedules, create events, check availability
Tasks — create, update, and complete tasks

OpenClaw can operate Feishu content directly as the app—no manual copy-paste between tools.

Common Issues

Bot not responding: Verify the app version is published and events use WebSocket.
Permission errors: Confirm scopes are approved and the app has the required access.
Config drift: Avoid changing both Feishu and OpenClaw config at the same time—debugging becomes difficult.
Skipping initialization: Even if the bot replies, run workspace initialization (IDENTITY.md, USER.md, SOUL.md, AGENTS.md, TOOLS.md) before heavy use.

Minimal Validation

After setup, send a simple message like:

Summarize today's meetings in one sentence and reply back.

If the bot replies consistently, the Feishu integration is working.