moltbot-channel-feishu

A Feishu/Lark channel plugin for OpenClaw / Moltbot / Clawdbot.

Project Status (March 2026)

This plugin was created when OpenClaw (ex. Clawbot/Moltbot) did not yet provide a built-in Feishu/Lark channel.

OpenClaw now has an official Feishu channel. For new deployments, use the official solution instead of this plugin:

• https://docs.openclaw.ai/channels/feishu

This repository stays available for legacy setups and migration reference.

Install (Legacy only)

# OpenClaw (legacy/testing only)
openclaw plugins install moltbot-channel-feishu

# Moltbot (legacy)
moltbot plugins install moltbot-channel-feishu

# Clawdbot (legacy)
clawdbot plugins install moltbot-channel-feishu

# From GitHub (for testing)
openclaw plugins install github:samzong/moltbot-channel-feishu

Configure

Edit ~/.openclaw/openclaw.json (or ~/.moltbot/moltbot.json / ~/.clawdbot/clawdbot.json):

{
  "channels": {
    "feishu": {
      "enabled": true,
      "appId": "cli_xxx",
      "appSecret": "xxx",
      "domain": "feishu",
      "dmPolicy": "pairing",
      "groupPolicy": "open"
    }
  }
}

Or use environment variables (takes precedence if config values are empty):

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

Configuration Options

| Field | Type | Default | Description | |-------|------|---------|-------------| | enabled | boolean | false | Enable/disable the channel | | appId | string | - | Feishu App ID | | appSecret | string | - | Feishu App Secret | | domain | "feishu" | "lark" | "feishu" | API domain (China / International) | | dmPolicy | "open" | "pairing" | "allowlist" | "pairing" | DM access policy | | allowFrom | string[] | [] | User IDs allowed for DM (when dmPolicy: "allowlist") | | groupPolicy | "open" | "allowlist" | "disabled" | "allowlist" | Group chat access policy | | groupAllowFrom | string[] | [] | Group IDs allowed (when groupPolicy: "allowlist") | | requireMention | boolean | true | Require @mention in groups |

Feishu App Setup

1. Go to Feishu Open Platform
2. Create a self-built app
3. Enable permissions: im:message, im:chat, contact:user.base:readonly
4. Events → Use Long Connection mode
5. Subscribe to event: im.message.receive_v1
6. Get App ID and App Secret from Credentials page
7. Publish the app

License

MIT