Back to README

Feishu

Feishu (international name: Lark) is an enterprise collaboration platform by ByteDance. It supports both Chinese and global markets through event-driven WebSocket connections.

Configuration

json

{
  "channel_list": {
    "feishu": {
      "enabled": true,
      "type": "feishu",
      "app_id": "cli_xxx",
      "app_secret": "xxx",
      "encrypt_key": "",
      "verification_token": "",
      "allow_from": []
    }
  }
}

Field	Type	Required	Description
enabled	bool	Yes	Whether to enable the Feishu channel
app_id	string	Yes	App ID of the Feishu application (starts with `cli_`)
app_secret	string	Yes	App Secret of the Feishu application
encrypt_key	string	No	Encryption key for event callbacks
verification_token	string	No	Token used for Webhook event verification
allow_from	array	No	Allowlist of user IDs; empty means all users are allowed
random_reaction_emoji	array	No	List of random reaction emojis; empty uses the default "Pin"

Setup

Go to the Feishu Open Platform and create an application
Enable the Bot capability in the application settings
Create a version and publish the application (configuration takes effect only after publishing)
Obtain the App ID (starts with cli_) and App Secret
Fill in the App ID and App Secret in the PicoClaw configuration file
Run picoclaw gateway to start the service
Search for the bot name in Feishu and start a conversation

PicoClaw connects to Feishu using WebSocket/SDK mode — no public callback address or Webhook URL is required.

encrypt_key and verification_token are optional; enabling event encryption is recommended for production environments.

For custom emoji references, see: Feishu Emoji List

Platform Limitations

⚠️ Feishu channel does not support 32-bit devices. The Feishu SDK only provides 64-bit builds. Devices running armv6, armv7, mipsle, or other 32-bit architectures cannot use the Feishu channel. For messaging on 32-bit devices, use Telegram, Discord, or OneBot instead.