Feishu File Upload

Upload local files to Feishu Drive and send as file messages to chats or users.

When to Use

• - User asks to "send file", "upload file", or "share file" to Feishu
• Need to share documents (CSV, PDF, Excel, Word) with group or individual
• Bot needs to send files that Feishu's native message API doesn't support directly
• Images/videos: Use media parameter in message tool instead (no need for this skill)

Quick Start

Send to Group Chat

Send to Individual User

Send via Email

Use Environment Variable

How It Works

1. 1. Read credentials from ~/.openclaw/openclaw.json (channels.feishu.appId/appSecret)
2. Get tenant access token from Feishu Auth API
3. Upload file to Feishu Drive → returns INLINECODE2
4. Send file message using file_key to target chat/user

Script Usage

Arguments

*Not required if --env is used

Receive ID Types

Extract Chat ID from Feishu Message

From Feishu message metadata:

{
  "conversation_label": "oc_06a6b40e03e98e41c8aebcbed8b09871"
}

From sender info:

{
  "sender_id": "ou_b0f83ea276761ab10ebb3f4f277453b8"
}

Prerequisites

• - Python 3.6+
• INLINECODE32 library: INLINECODE33
• Feishu bot credentials in INLINECODE34

Feishu API Permissions

Bot needs these permissions in Feishu Developer Console:

Required for file upload:

• - im:resource:upload - Upload files (preferred)
• OR im:resource - Read and upload files

Required for sending messages:

• - im:message - Send messages to chats

How to Enable Permissions

1. 1. Open Feishu Developer Console: https://open.feishu.cn/app/YOURAPPID/auth
2. Search for im:resource:upload or INLINECODE39
3. Click "Apply" and enable the permission
4. Wait a few minutes for permission to take effect

Quick link: https://open.feishu.cn/app/cli_a94a21db99385bd8/auth?q=im:resource:upload,im:resource

File Size Limits

• - Single file: 30MB max (Feishu API limit)
• Large files may take longer to upload

Supported File Types

All file types supported by Feishu Drive:

Error Handling

Script handles:

• - Missing credentials → Error message
• File not found → Error message
• Upload failure → API error details
• Send failure → API error details
• Missing permissions → Clear error with fix link

Testing

CODEBLOCK6

Troubleshooting

"Access denied" / "99991672"

• - Bot lacks im:resource:upload or im:resource permission
• Open: https://open.feishu.cn/app/cli_a94a21db99385bd8/auth?q=im:resource:upload,im:resource
• Enable permission and wait a few minutes

"Bot/User can NOT be out of the chat (230002)"

• - Bot is not a member of the target group chat
• Add bot to the chat, or send to a different chat

"Invalid receive_id"

• - Check the ID format matches the type
• INLINECODE42 starts with INLINECODE43
• INLINECODE44 starts with INLINECODE45
• INLINECODE46 is numeric
• INLINECODE47 must be valid email format

Upload fails for large files

• - Feishu API limit is 30MB
• Compress file or use Feishu Drive web interface for larger files

Alternative: Manual Upload

If script fails, user can manually:

1. 1. Upload file to Feishu Drive via web/app
2. Share file with the chat
3. Bot can then reference the file

Security Notes

• - Credentials read from openclaw.json (local only)
• Token expires after ~2 hours (auto-refreshed each run)
• Files uploaded to Feishu Drive follow Feishu's security policies
• Script does not store or transmit credentials

Comparison with Message Tool

Recommendation: Use media parameter for images/videos, use this skill for documents and other files.