Feishu (Lark)

Deploy Mona as a Feishu (Lark) bot for enterprise messaging.

Prerequisites

• A working MonoClaw installation
• A Feishu/Lark developer account
• An organization with admin access

1. Create a Feishu app

1. Go to open.feishu.cn (China) or open.larksuite.com (International)
2. Click Create Custom App
3. Fill in app information
4. Note the App ID and App Secret

2. Enable bot capability

1. In your app settings, go to Capability Addition
2. Add Bot
3. Enable Receive messages and Send messages
4. Set the event subscription URL: https://your-domain.com/webhooks/feishu
5. Set the verification token and encrypt key

3. Configure MonoClaw

monoclaw gateway setup

Choose Feishu and enter:

• App ID
• App Secret
• Verification Token
• Encrypt Key (optional)

Or manually:

monoclaw config set FEISHU_APP_ID "cli_..."
monoclaw config set FEISHU_APP_SECRET "your-secret"
monoclaw config set FEISHU_VERIFICATION_TOKEN "your-token"

4. Start the gateway

monoclaw gateway start

5. Publish the app

1. In Feishu developer portal, go to Version Management
2. Create a version
3. Request approval from organization admin
4. Once approved, the bot is available to users

Interaction

Group chats

Add the bot to a Feishu group:

1. In group settings, click Add Bot
2. Search for your app name
3. @mention the bot to interact

@Mona 总结今天的会议纪要

DMs

Search for the bot in Feishu and send messages directly.

Configuration

gateway:
  feishu:
    app_id: "${FEISHU_APP_ID}"
    app_secret: "${FEISHU_APP_SECRET}"
    verification_token: "${FEISHU_VERIFICATION_TOKEN}"
    encrypt_key: "${FEISHU_ENCRYPT_KEY}"
    event_url: "https://your-domain.com/webhooks/feishu"

Troubleshooting