Feishu Media Delivery#

Use this skill as the last-mile delivery layer for multimodal agents.

It does not generate content. It only makes sure already-generated files are sent to Feishu with the correct protocol.

What this skill is for#

Use this skill when you already have a generated result and need to deliver it to a Feishu user/chat.

Typical cases:

• A generated jpg/png must be sent as a real Feishu image message
• A generated mp4 must be sent as a real Feishu media message
• A multimodal agent finished generation and now needs reliable delivery
• You want to avoid protocol mistakes like sending jpg/mp4 as the wrong message type

Hard rules#

Images#

For images, do not send the local file as plain text or guess a generic attachment format.

Correct flow:

1. Upload image to Feishu IM resource API
2. Get image_key
3. Send message with msg_type=image

Use:

• scripts/send-image.mjs

Videos#

For mp4 videos, do not send them as file messages.

Correct flow:

1. Upload mp4 to Feishu IM file API
2. Get file_key
3. Send message with msg_type=media

Use:

• scripts/send-media.mjs

Required environment#

The scripts expect:

• FEISHU_APP_ID
• FEISHU_APP_SECRET_PATH or default secret file at ~/.openclaw/secrets/feishu_app_secret

Default secret path:

• ~/.openclaw/secrets/feishu_app_secret

Receive ID assumptions#

The bundled scripts default to receive_id_type=open_id.

Use them directly when the target is a Feishu user open_id like:

• ou_xxx

If you need group delivery later, extend the script to accept chat_id and switch receive_id_type.

Commands#

Send image to a Feishu user#

bash

cd scripts
node send-image.mjs <open_id> /path/to/image.jpg

Example:

bash

cd scripts
node send-image.mjs ou_xxx /tmp/result.jpg

Send mp4 video to a Feishu user#

bash

cd scripts
node send-media.mjs <open_id> /path/to/video.mp4 mp4 5000

Arguments:

• arg1: target open_id
• arg2: local mp4 path
• arg3: file type, usually mp4
• arg4: duration in milliseconds, optional but recommended

Example:

bash

cd scripts
node send-media.mjs ou_xxx /tmp/result.mp4 mp4 5000

Output expectations#

A successful send should return Feishu success payloads such as:

• code: 0
• msg: success

Do not assume transport success only from local script execution. Check the returned Feishu response.

Fallback policy#

Image fallback#

If real Feishu image sending fails, report that image delivery failed. Do not silently pretend the image was delivered.

Video fallback#

If Feishu media sending fails, fallback to sending a direct link if one exists. State clearly that this is a fallback.

Recommended agent usage#

For a multimodal content agent, use this skill after generation:

• image result -> send-image.mjs
• mp4 result -> send-media.mjs

This keeps protocol details out of the model prompt and reduces failure risk for weaker models.