​

Feishu bot

​

Plugin required

openclaw plugins install @openclaw/feishu

openclaw plugins install ./extensions/feishu

​

Quickstart

​

Method 1: onboarding wizard (recommended)

openclaw onboard

1. Creating a Feishu app and collecting credentials
2. Configuring app credentials in OpenClaw
3. Starting the gateway

• openclaw gateway status
• openclaw logs --follow

​

Method 2: CLI setup

openclaw channels add

• openclaw gateway status
• openclaw gateway restart
• openclaw logs --follow

​

Step 1: Create a Feishu app

​

1. Open Feishu Open Platform

​

2. Create an app

1. Click Create enterprise app
2. Fill in the app name + description
3. Choose an app icon

​

3. Copy credentials

• App ID (format: cli_xxx)
• App Secret

​

4. Configure permissions

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

​

5. Enable bot capability

1. Enable bot capability
2. Set the bot name

​

6. Configure event subscription

1. You already ran openclaw channels add for Feishu
2. The gateway is running (openclaw gateway status)

1. Choose Use long connection to receive events (WebSocket)
2. Add the event: im.message.receive_v1

​

7. Publish the app

1. Create a version in Version Management & Release
2. Submit for review and publish
3. Wait for admin approval (enterprise apps usually auto-approve)

​

Step 2: Configure OpenClaw

​

Configure with the wizard (recommended)

openclaw channels add

​

Configure via config file

{
  channels: {
    feishu: {
      enabled: true,
      dmPolicy: "pairing",
      accounts: {
        main: {
          appId: "cli_xxx",
          appSecret: "xxx",
          botName: "My AI assistant",
        },
      },
    },
  },
}

​

Configure via environment variables

export FEISHU_APP_ID="cli_xxx"
export FEISHU_APP_SECRET="xxx"

​

Lark (global) domain

{
  channels: {
    feishu: {
      domain: "lark",
      accounts: {
        main: {
          appId: "cli_xxx",
          appSecret: "xxx",
        },
      },
    },
  },
}

​

Step 3: Start + test

​

1. Start the gateway

openclaw gateway

​

2. Send a test message

​

3. Approve pairing

openclaw pairing approve feishu <CODE>

​

Overview

• Feishu bot channel: Feishu bot managed by the gateway
• Deterministic routing: replies always return to Feishu
• Session isolation: DMs share a main session; groups are isolated
• WebSocket connection: long connection via Feishu SDK, no public URL needed

​

Access control

​

Direct messages

• Default: dmPolicy: "pairing" (unknown users get a pairing code)
• Approve pairing:
  Copy

  openclaw pairing list feishu
  openclaw pairing approve feishu <CODE>
  
• Allowlist mode: set channels.feishu.allowFrom with allowed Open IDs

​

Group chats

• "open" = allow everyone in groups (default)
• "allowlist" = only allow groupAllowFrom
• "disabled" = disable group messages

• true = require @mention (default)
• false = respond without mentions

​

Group configuration examples

​

Allow all groups, require @mention (default)

{
  channels: {
    feishu: {
      groupPolicy: "open",
      // Default requireMention: true
    },
  },
}

​

Allow all groups, no @mention required

{
  channels: {
    feishu: {
      groups: {
        oc_xxx: { requireMention: false },
      },
    },
  },
}

​

Allow specific users in groups only

{
  channels: {
    feishu: {
      groupPolicy: "allowlist",
      groupAllowFrom: ["ou_xxx", "ou_yyy"],
    },
  },
}

​

Get group/user IDs

​

Group IDs (chat_id)

1. Start the gateway and @mention the bot in the group
2. Run openclaw logs --follow and look for chat_id

​

User IDs (open_id)

1. Start the gateway and DM the bot
2. Run openclaw logs --follow and look for open_id

openclaw pairing list feishu

​

Common commands

Note: Feishu does not support native command menus yet, so commands must be sent as text.

​

Gateway management commands

​

Troubleshooting

​

Bot does not respond in group chats

1. Ensure the bot is added to the group
2. Ensure you @mention the bot (default behavior)
3. Check groupPolicy is not set to "disabled"
4. Check logs: openclaw logs --follow

​

Bot does not receive messages

1. Ensure the app is published and approved
2. Ensure event subscription includes im.message.receive_v1
3. Ensure long connection is enabled
4. Ensure app permissions are complete
5. Ensure the gateway is running: openclaw gateway status
6. Check logs: openclaw logs --follow

​

App Secret leak

1. Reset the App Secret in Feishu Open Platform
2. Update the App Secret in your config
3. Restart the gateway

​

Message send failures

1. Ensure the app has im:message:send_as_bot permission
2. Ensure the app is published
3. Check logs for detailed errors

​

Advanced configuration

​

Multiple accounts

{
  channels: {
    feishu: {
      accounts: {
        main: {
          appId: "cli_xxx",
          appSecret: "xxx",
          botName: "Primary bot",
        },
        backup: {
          appId: "cli_yyy",
          appSecret: "yyy",
          botName: "Backup bot",
          enabled: false,
        },
      },
    },
  },
}

​

Message limits

• textChunkLimit: outbound text chunk size (default: 2000 chars)
• mediaMaxMb: media upload/download limit (default: 30MB)

​

Streaming

​

Configuration reference

​

dmPolicy reference

​

Supported message types

​

Receive

• ✅ Text
• ✅ Images
• ✅ Files
• ✅ Audio
• ✅ Video
• ✅ Stickers

​

Send

• ✅ Text
• ✅ Images
• ✅ Files
• ✅ Audio
• ⚠️ Rich text (partial support)