feishu-image-uploader

Upload local image files to Feishu and return an embed-ready image_key.

Updated Apr 5, 2026
One-click install
npx skills add https://github.com/dingdyan/openclaw-workspace-v2 --skill feishu-image-uploader
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: feishu-image-uploader
Source: https://github.com/dingdyan/openclaw-workspace-v2/tree/main/skills/feishu-image-uploader
Command: npx skills add https://github.com/dingdyan/openclaw-workspace-v2 --skill feishu-image-uploader

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @larksuiteoapi/node-sdk.

What problem does it solve?

This Skill removes the manual hassle of uploading local images to Feishu and figuring out the correct key to embed them into messages.

Core Features & Use Cases

  • Upload local images to Feishu: Takes a local image file path, uploads it via Feishu’s file API, and returns the usable key.
  • Return image_key for message embedding: Prints the image_key so you can reference the image in subsequent Feishu rich message payloads.
  • Supported formats: JPEG/JPG, PNG, GIF, and WEBP.

Quick Start

Run the Skill by uploading your local image file and reading the printed image_key.

Frequently Asked Questions about feishu-image-uploader

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I upload a local image to Feishu and get an image_key for message embedding?

To upload a local image to Feishu and get an image_key, you can use a Node.js Skill that calls the Feishu file API to upload your local image file and returns the usable key for message embedding.

What image formats are supported for Feishu bot image uploads?

Feishu bot image uploads support JPEG, JPG, PNG, GIF, and WEBP formats. The uploader takes a local image file path in one of these formats and processes it through the Feishu file API.

Do I need environment variables to programmatically upload images to Feishu using Node.js?

Yes, you need to set the FEISHU_APP_ID and FEISHU_APP_SECRET environment variables to authenticate with the Feishu API and perform programmatic image uploads using the Node.js SDK.

What's the best way to include generated images in Feishu chatops and bot workflows?

The best way to include generated images in Feishu chatops and bot workflows is to upload the local image file via the Feishu im.file.create API, retrieve the printed image_key, and reference it in subsequent rich message payloads.

Why does my Feishu image upload fail when using @larksuiteoapi/node-sdk?

Feishu image uploads using @larksuiteoapi/node-sdk fail if FEISHU_APP_ID or FEISHU_APP_SECRET environment variables are missing or invalid, as these credentials are required to authenticate the im.file.create upload request.