Feishu File Send

Use this skill whenever you need to send a file to a Feishu user, or when a Feishu user reports they did not receive an attachment.

Core rule

For Feishu, do not combine text and attachment in one outbound message when reliability matters.

Always use this sequence:

1. Prepare the file in an allowed local path.
2. Send a short text message first, if any explanation is needed.
3. Send the attachment as a separate outbound message.

When this skill should trigger

Use it when the user asks you to:

• send a file
• return an edited document
• deliver a generated Word, Excel, PDF, PPT, TXT, image, or similar attachment
• test Feishu attachment sending
• debug missing Feishu attachments
• diagnose file delivery failures in Feishu

This skill is especially important in Feishu DMs, but the same pattern is also safer in Feishu groups.

Required workflow

1. Check the file path

Before sending, ensure the file lives under an allowed mediaLocalRoots directory.

Known-good path in most setups:

• ~/.openclaw/workspace/ (the default workspace directory)

If a generated file is under /tmp/ or another temporary path, move or copy it into an allowed directory before sending, unless you already know that path is whitelisted in mediaLocalRoots.

2. Send text separately

If you need to say something like “here is the file” or explain what changed, send that as a plain text message first.

Keep it short.

3. Send the attachment separately

Send the file in its own message using the message tool with media set to the local file path.

Do not attach explanatory text to the same outbound file message.

What to avoid

Do not:

• combine text and file in one Feishu outbound message when attachment visibility matters
• assume /tmp/openclaw/ is safe to send from
• use MEDIA: inline attachment rendering for Feishu when you need reliable file delivery, if you can directly use the message tool instead

Delivery pattern

Preferred pattern:

1. message.send with text only
2. message.send with media only
3. After tool success, do not duplicate the same content again in chat

If you use message to deliver the user-visible reply, answer with NO_REPLY.

Failure diagnosis

If the recipient says they did not receive the file:

1. Confirm whether plain text messages are arriving.
2. Confirm whether the file was sent as a standalone attachment message.
3. Confirm the file path is inside mediaLocalRoots.
4. Retry by copying the file into ~/.openclaw/workspace/ (or another allowed directory) and re-sending.
5. If needed, consult references/feishu-file-sending-notes.md.

Known validated file types

Validated in Feishu DM on 2026-04-16 when sent separately:

• txt
• docx
• xlsx
• pdf

You may still send other file types, but if reliability matters and they fail, debug using the same path and separation rules.

Reference

For the full tested behavior and troubleshooting notes, read:

• references/feishu-file-sending-notes.md