Feishu File Sender#

Send files to Feishu/Lark users and chat groups with proper formatting and error handling.

When to Use#

Use this skill when:

• User wants to send a file via Feishu
• Need to deliver documents, images, PDFs to Feishu contacts
• Transferring generated files (reports, exports, etc.) to Feishu
• Sharing any file through Feishu messaging

Quick Start#

python

# Basic file send
message action=send filePath="/path/to/file.pdf"

# With custom message
message action=send filePath="/path/to/report.docx" message="Here's the report you requested"

File Types Supported#

• Documents: .pdf, .doc, .docx, .txt, .md
• Spreadsheets: .xls, .xlsx, .csv
• Images: .jpg, .jpeg, .png, .gif, .webp
• Archives: .zip, .rar, .tar.gz
• Code files: .py, .js, .html, .json, etc.

Usage Examples#

Send a Single File#

python

message action=send filePath="/workspace/report.pdf"

Send with Caption#

python

message action=send filePath="/workspace/data.xlsx" message="Q4 sales data"

Send Multiple Files#

Send files one by one with context:

python

for file in files:
    message action=send filePath=file

Send to Specific Target#

python

# To a specific user
message action=send target="user:ou_xxx" filePath="/path/to/file"

# To a specific chat
message action=send target="chat:oc_xxx" filePath="/path/to/file"

Best Practices#

1. Always verify file exists before sending
2. Provide context with the message parameter when helpful
3. Check file size - Feishu has limits (typically 100MB-1GB depending on plan)
4. Use absolute paths to avoid confusion

Common Patterns#

After Generating a File#

python

# Generate report
exec command="python generate_report.py"

# Send to user
message action=send filePath="/workspace/output/report.pdf" message="Your report is ready"

Batch File Delivery#

python

# Collect all generated files
files = ["/workspace/file1.pdf", "/workspace/file2.xlsx"]

for i, file in enumerate(files, 1):
    message action=send filePath=file message=f"File {i} of {len(files)}"

Error Handling#

Common issues and solutions:

ErrorCauseSolutionFile not foundWrong pathUse absolute path with filePathAccess deniedPermissionsCheck file permissions with ls -laToo largeFile size limitCompress or split fileChannel errorFeishu configVerify channel is properly configured

Tool Reference#

message tool (action=send)#

yaml

action: send
filePath: /absolute/path/to/file    # Required: path to file
message: "Optional caption text"    # Optional: accompanying message
target: "user:xxx" or "chat:xxx"   # Optional: specific recipient
channel: feishu                     # Optional: defaults to current

Related Skills#

• auto-file-sender - Automatic file sending when files are generated
• feishu-file-transfer - Large file transfer via Feishu API

---

Version: 1.0

Compatible with: OpenClaw v1.x+

Platform: Feishu / Lark