mzs-code/ai-wiki/feishu-image-or-files

Claude Code and agent skill by mzs-code/ai-wiki

Trust tier 2
  • community
LLM review pending
Source check pending

Checking that the SKILL.md file is still in the repository.

Send images or files to Feishu groups via official API. Use when user asks to send/upload to Feishu. Choose image type for: "发图片"/"send image"/"share screenshot". Choose file type for: "发文件"/"send file"/"以文件形式发送". When OpenClaw's message tool with media parameter fails, also use this skill.

Install

npx vskill@latest install mzs-code/ai-wiki/feishu-image-or-files

SKILL.md

Feishu Image & File Upload

Prerequisites

  • Feishu bot with im:resource permission enabled
  • Bot configured in ~/.openclaw/openclaw.json

Workflow

Step 1: Get bot credentials

Use the helper script:

bash
python3 scripts/get-bot-config.py <chat_id>
# Returns: {"account": "default", "app_id": "cli_xxx", "app_secret": "xxx"}

Or read ~/.openclaw/openclaw.json directly — look under messages.feishu.accounts and match groupAllowFrom to the target chat_id.

Step 2: Send image or file

Use the unified send script:

bash
# Send as image (for image files)
bash scripts/feishu-send-media.sh image <image_path> <chat_id> <app_id> <app_secret>
 
# Send as file (for any file type)
bash scripts/feishu-send-media.sh file <file_path> <chat_id> <app_id> <app_secret>
Manual API steps (if needed)

For images:

bash
# 1. Get token
TOKEN=$(curl -s -X POST 'https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal' \
  -H 'Content-Type: application/json' \
  -d '{"app_id":"<appId>","app_secret":"<appSecret>"}' \
  | python3 -c "import json,sys; print(json.load(sys.stdin)['tenant_access_token'])")
 
# 2. Upload image → get image_key
IMAGE_KEY=$(curl -s -X POST 'https://open.feishu.cn/open-apis/im/v1/images' \
  -H "Authorization: Bearer $TOKEN" \
  -F 'image_type=message' \
  -F 'image=@/path/to/image.png' \
  | python3 -c "import json,sys; print(json.load(sys.stdin)['data']['image_key'])")
 
# 3. Send image message
curl -s -X POST 'https://open.feishu.cn/open-apis/im/v1/messages?receive_id_type=chat_id' \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d "{\"receive_id\":\"<chat_id>\",\"msg_type\":\"image\",\"content\":\"{\\\"image_key\\\":\\\"$IMAGE_KEY\\\"}\"}"

For files:

bash
# 1. Get token (same as above)
 
# 2. Upload file → get file_key
FILE_KEY=$(curl -s -X POST 'https://open.feishu.cn/open-apis/im/v1/files' \
  -H "Authorization: Bearer $TOKEN" \
  -F 'file_type=stream' \
  -F 'file_name=filename.ext' \
  -F 'file=@/path/to/file.ext' \
  | python3 -c "import json,sys; print(json.load(sys.stdin)['data']['file_key'])")
 
# 3. Send file message
curl -s -X POST 'https://open.feishu.cn/open-apis/im/v1/messages?receive_id_type=chat_id' \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d "{\"receive_id\":\"<chat_id>\",\"msg_type\":\"file\",\"content\":\"{\\\"file_key\\\":\\\"$FILE_KEY\\\"}\"}"

Notes

  • Token expires in ~2 hours — always fetch fresh
  • Image limits: 10MB max; formats: JPEG, PNG, WEBP, GIF, TIFF, BMP, ICO
  • File limits: 30MB max; any file type
  • OpenClaw message tool media parameter is unreliable for Feishu — use this skill instead

Security

  • Security scanPassed, 100 of 100Pattern checks on the skill's files.
  • Model reviewNot runA model review is scheduled for the next rescan.

See the full security report

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

See evaluation results

Source

Popularity

Repository stars
64
Repository forks
13
7-day trend score
21

Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/mzs-code/ai-wiki/feishu-image-or-files/badge)](https://verified-skill.com/skills/mzs-code/ai-wiki/feishu-image-or-files)

Something wrong with this skill or its page? Tell us.