Getting Started

This guide will help you quickly install and configure the OpenClaw Feishu plugin.

Requirements

• Node.js: v22 or higher
• OpenClaw: 2026.2.26 or higher

Installation

1. Install OpenClaw Feishu Plugin

openclaw plugin install feishu

Or install via npm:

npm install -g @larksuite/openclaw-lark

2. Create App in Feishu Open Platform

1. Visit Feishu Open Platform
2. Create a self-built app
3. Get your App ID and App Secret

3. Configure App Permissions

In the app's Permission Management, enable the following permissions:

Required Permissions

Permission	Description
im:message:send_as	Send messages
im:message:send_as_bot	Send messages as bot
im:message:receive	Receive messages
im:chat:readonly	Read group chat info
im:chat:update_group_name	Update group name

Optional Permissions (as needed)

Permission	Description
doc:readonly	Read documents
doc:upload	Upload documents
doc:create	Create documents
bitable:readonly	Read bitable
bitable:create	Create bitable
calendar:readonly	Read calendar
calendar:event:create	Create calendar events
task:readonly	Read tasks
task:create	Create tasks

4. Configure OpenClaw

Edit ~/.openclaw/openclaw.json:

{
  "channels": {
    "feishu": {
      "enabled": true,
      "appId": "your_app_id",
      "appSecret": "your_app_secret"
    }
  }
}

5. Start OpenClaw

openclaw gateway restart

First Authorization

After installation, users need to authorize via OAuth:

1. User sends a message to the bot
2. Bot sends authorization card
3. User clicks authorize and completes login
4. After authorization, all features are available

Verify Installation

Send a test message to the bot and confirm it responds correctly.

Next Steps

• Configuration Guide - Learn more configuration options
• Tool Reference - Learn all available tools