Clawdbot Feishu Integration

Clawdbot Feishu Integration Overview

Clawdbot Feishu integration enables you to connect your personal AI assistant to Feishu (飞书), ByteDance's enterprise collaboration platform also known as Lark internationally. With Clawdbot Feishu, you can automate workplace communications, provide intelligent responses, and enhance team productivity through AI-powered automation.

Why Use Clawdbot with Feishu?

Feishu is a comprehensive workplace platform combining messaging, documents, calendar, and video conferencing. Integrating Clawdbot with Feishu provides:

Setting Up Clawdbot Feishu

Prerequisites

Before connecting Clawdbot to Feishu, ensure you have:

• Clawdbot installed on your device
• A Feishu account (personal or enterprise)
• Feishu Developer Console access
• App creation permissions

Step 1: Create a Feishu Application

Set up your Clawdbot Feishu application:

1. Go to Feishu Open Platform
2. Click "Create Custom App"
3. Name your Clawdbot Feishu application
4. Configure app capabilities (Bot, Docs, Calendar)
5. Obtain App ID and App Secret

Step 2: Configure Clawdbot Feishu

Add your Feishu app to Clawdbot:

clawdbot channels add feishu --app-id YOUR_APP_ID --app-secret YOUR_APP_SECRET

Step 3: Set Up Permissions

Configure Clawdbot Feishu permissions:

Required permissions for Clawdbot Feishu:

• im:message - Send and receive messages
• im:chat - Access chat information
• contact:user.base - Read user information
• docs:doc - Access documents (optional)
• calendar:calendar - Calendar access (optional)

Step 4: Deploy Clawdbot Feishu Bot

Publish your Clawdbot Feishu bot:

clawdbot channels start feishu

Step 5: Verify Clawdbot Feishu Connection

Check your Clawdbot Feishu status:

clawdbot channels status feishu

Expected output:

Feishu Channel Status:
- Connection: Connected
- App: Clawdbot Assistant
- Mode: Event Subscription
- Clawdbot: Active

Clawdbot Feishu Features

Message Handling

Clawdbot Feishu processes various message types:

Interactive Cards

Clawdbot Feishu supports interactive message cards:

clawdbot configure feishu --cards enabled

Features:

• Button interactions
• Form submissions
• Dynamic content updates
• Action callbacks

Group Chat Integration

Add Clawdbot Feishu to group chats:

clawdbot configure feishu --groups "Team A,Project X"

Configure Clawdbot Feishu to respond to:

• All messages
• Mentions only (@Clawdbot)
• Slash commands (/ask, /help)

Document Integration

Clawdbot Feishu can interact with Feishu Docs:

• Summarize documents
• Answer questions about content
• Extract key information
• Create document drafts

clawdbot feishu docs summarize --doc-id DOC_ID

Calendar Integration

Use Clawdbot Feishu for calendar management:

• Schedule meetings
• Check availability
• Send meeting reminders
• Create calendar events

clawdbot feishu calendar schedule --title "Team Meeting" --time "2024-01-15 10:00"

Slash Commands

Clawdbot Feishu supports custom slash commands:

Clawdbot Feishu Configuration

App Settings

Configure your Clawdbot Feishu application:

{
  "feishu": {
    "appId": "YOUR_APP_ID",
    "appSecret": "YOUR_APP_SECRET",
    "encryptKey": "YOUR_ENCRYPT_KEY",
    "verificationToken": "YOUR_VERIFICATION_TOKEN",
    "eventSubscription": true
  }
}

Event Subscription

Set up Clawdbot Feishu event subscription:

clawdbot configure feishu --webhook https://your-domain.com/feishu/events

Subscribed events:

• im.message.receive_v1 - Message received
• im.chat.member.bot.added_v1 - Bot added to chat
• im.chat.member.bot.deleted_v1 - Bot removed from chat

Enterprise Deployment

For enterprise Clawdbot Feishu deployment:

1. Submit app for review
2. Configure tenant permissions
3. Deploy to organization
4. Set up admin controls

Clawdbot Feishu Credential Storage

Clawdbot stores Feishu credentials securely:

~/.clawdbot/credentials/feishu/app_credentials.json
~/.clawdbot/credentials/feishu/tenant_token.json

Your Clawdbot Feishu data remains on your local machine.

Clawdbot Feishu Use Cases

Team Assistant

Deploy Clawdbot Feishu as a team assistant:

• Answer team questions
• Summarize discussions
• Track action items
• Provide information lookup

Meeting Helper

Use Clawdbot Feishu for meetings:

• Schedule meetings automatically
• Send meeting summaries
• Track follow-ups
• Manage attendees

Knowledge Base

Clawdbot Feishu as a knowledge assistant:

• Search company documents
• Answer policy questions
• Provide onboarding help
• Share best practices

Project Management

Clawdbot Feishu for project teams:

• Status updates
• Task reminders
• Progress tracking
• Team coordination

Troubleshooting Clawdbot Feishu

Bot Not Responding

If Clawdbot Feishu doesn't respond:

1. Verify app credentials: clawdbot channels verify feishu
2. Check event subscription URL
3. Review logs: cat /tmp/clawdbot/feishu.log

Permission Errors

If Clawdbot Feishu lacks permissions:

1. Review app permissions in Developer Console
2. Re-authorize the application
3. Check tenant-level restrictions

Event Subscription Issues

If Clawdbot Feishu events fail:

1. Verify webhook URL accessibility
2. Check encryption key configuration
3. Review event subscription settings

Clawdbot Feishu Best Practices

1. Use Event Subscription: Clawdbot Feishu performs better with webhooks
2. Configure Permissions Carefully: Only request necessary permissions
3. Handle Rate Limits: Implement proper rate limiting for Clawdbot Feishu
4. Monitor Usage: Track Clawdbot Feishu bot analytics
5. Enterprise Compliance: Follow organization security policies

Clawdbot Feishu vs Lark

Clawdbot supports both Feishu (China) and Lark (International):

Next Steps

• Clawdbot WeChat Integration - Connect Clawdbot to WeChat
• Clawdbot Telegram Integration - Set up Clawdbot on Telegram
• Clawdbot Setup Guide - Complete installation guide