- name
- feishu-file-send
- description
- Reliable Feishu file sending workflow. Strongly prefer this skill whenever a Feishu user asks for a file, asks you to send or return a document, or whenever you are about to deliver any attachment in a Feishu DM or group. Use for generated or edited docx, xlsx, pdf, txt, pptx, images, archives, and other local files. Also use when diagnosing Feishu attachment delivery failures, missing attachments, mediaLocalRoots path issues, or cases where text plus attachment was combined and the recipient did not receive the file. In any Feishu conversation involving outbound files or attachment troubleshooting, this skill should usually be selected.
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:
- Prepare the file in an allowed local path.
- Send a short text message first, if any explanation is needed.
- 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 themessagetool instead
Delivery pattern
Preferred pattern:
message.sendwith text onlymessage.sendwith media only- 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:
- Confirm whether plain text messages are arriving.
- Confirm whether the file was sent as a standalone attachment message.
- Confirm the file path is inside
mediaLocalRoots. - Retry by copying the file into
~/.openclaw/workspace/(or another allowed directory) and re-sending. - 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
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