lark-file-sender

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:

Quick Start

# 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

Usage Examples

Send a Single File

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

Send with Caption

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

Send Multiple Files

Send files one by one with context:

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

Send to Specific Target

# 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

# 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

# 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:

| Error | Cause | Solution | |-------|-------|----------| | File not found | Wrong path | Use absolute path with filePath | | Access denied | Permissions | Check file permissions with ls -la | | Too large | File size limit | Compress or split file | | Channel error | Feishu config | Verify channel is properly configured |

Tool Reference

message tool (action=send)

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

*Version: 1.0* *Compatible with: OpenClaw v1.x+* *Platform: Feishu / Lark*

# 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"

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