Agent skill

Feishu Upload Image

by smallnest in smallnest/goclaw

Upload images to Feishu/Lark. An agent skill from smallnest/goclaw.

MITAuto-check passedProductivity & Automation

Install Feishu Upload Image

skills CLI
$ npx skills add smallnest/goclaw --skill feishu-upload-image -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install smallnest/goclaw feishu-upload-image --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/smallnest/goclaw.git skills-src && mkdir -p .claude/skills && cp -r skills-src/internal/builtin_skills/feishu-upload-image .claude/skills/feishu-upload-image && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
feishu-upload-image
GitHub stars
599
Token cost
~556 tokens
SKILL.md length
102 words
Files
3 (incl. scripts)
Skills in repo
6
Repo updated
First seen
Licence
MIT

At a glance

Upload images to Feishu/Lark. An agent skill from smallnest/goclaw.

  • Works in 2 steps: 飞书访问令牌 (tenant_access_token 或… → 接收者ID (open_id, user_id, chat_id, 或 email)
  • Tasks that involve Messaging and chat bots
  • SKILL.md covers Usage, Options, Limits and Response, plus 1 more section
  • Runs Python scripts from its folder; calls python3 and curl; reaches open.feishu.cn

What it does

Feishu Upload Image is an agent skill from smallnest/goclaw. Upload images to Feishu/Lark. Returns imagekey for use in messages.

Its SKILL.md is about 560 tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including scripts (for example `README.md` and `scripts/upload_image.py`).

It sits in Productivity & Automation, covering Messaging and chat bots. It works with Feishu (Lark). The repository describes itself as: An open-source AI assistant framework like openclaw. The licence is MIT.

When your agent uses it

  • Tasks that involve Messaging and chat bots

Example prompts

  • “/feishu-upload-image”

Requirements

  • Python 3

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

  1. 飞书访问令牌 (tenant_access_token 或 app_access_token)
  2. 接收者ID (open_id, user_id, chat_id, 或 email)

What it can do on your machine

Read from SKILL.md and the folder at commit e05c79d. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3
    • curl

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • open.feishu.cn

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Feishu Upload Image loads about 556 tokens when it runs. Until then it costs about 22 tokens; SKILL.md has 102 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~22
When it runs · the whole SKILL.md, loaded when a task matches
~556

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from smallnest/goclaw at commit e05c79d, republished under its MIT licence (© smallnest). 102 words, ~556 tokens.

Download SKILL.mdSave it as .claude/skills/feishu-upload-image/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
feishu-upload-image
description
Upload images to Feishu/Lark. Returns image_key for use in messages.
keywords
feishu, lark, upload, image, 图片上传, 飞书

Feishu Upload Image

Upload images to Feishu/Lark and get the image_key for use in messages.

Usage

Upload from Local File
bash
python3 ./scripts/upload_image.py /path/to/image.jpg
Upload via HTTP
bash
python3 ./scripts/upload_image.py --type message --image-type message https://example.com/image.jpg
Upload from Base64
bash
python3 ./scripts/upload_image.py --base64 "iVBORw0KGgoAAAANS..."

Options

OptionDescriptionDefault
`--type messageavatar`Image usage type
`--image-type messageavatar`Same as --type

Limits

  • Max file size: 10MB
  • Supported formats: JPEG, PNG, WEBP, GIF, TIFF, BMP, ICO
  • GIF resolution ≤ 2000×2000
  • Other formats ≤ 12000×12000

Response

Returns image_key which can be used in Feishu messages:

json
{
  "code": 0,
  "data": {
    "image_key": "img_v2_xxx"
  }
}

发送图片消息指南

获取必要信息
  1. 飞书访问令牌 (tenant_access_token 或 app_access_token)
  2. 接收者ID (open_id, user_id, chat_id, 或 email)
发送图片消息API

方式1:直接发送图片消息

bash
curl -X POST https://open.feishu.cn/open-apis/im/v1/messages \
  -H "Authorization: Bearer {access_token}" \
  -H "Content-Type: application/json" \
  -d '{
    "receive_id": "{chat_id}",
    "msg_type": "image",
    "content": "{\"image_key\":\"{image_key}\"}"
  }'

方式2:在富文本中嵌入图片

bash
curl -X POST https://open.feishu.cn/open-apis/im/v1/messages \
  -H "Authorization: Bearer {access_token}" \
  -H "Content-Type: application/json" \
  -d '{
    "receive_id": "{chat_id}",
    "msg_type": "post",
    "content": "{\"post\":{\"zh_cn\":{\"title\":\"图片消息\",\"content\":[[{\"tag\":\"img\",\"image_key\":\"{image_key}\"}]]}}}"
  }'
获取群聊chat_id
  1. 在飞书中打开群聊,查看URL中的chat_id
  2. 或者通过API查询群聊列表:
bash
curl -X GET https://open.feishu.cn/open-apis/im/v1/chats \
  -H "Authorization: Bearer {access_token}"
实践经验
  • 上传图片后获得 image_key,有效期通常为7天
  • 使用前需确保有正确的访问令牌权限
  • 发送消息需要 im:message:send_as_bot 权限
  • 建议先上传图片,再发送消息,两步操作分离

© smallnest, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (scripts) in internal/builtin_skills/feishu-upload-image of smallnest/goclaw.

  • SKILL.md
  • README.md
  • scripts/upload_image.py

Open the folder on GitHubat commit e05c79d

Compare with similar skills

Feishu Upload Image next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Feishu Upload Image compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Feishu Upload Image this skillsmallnest/goclaw599—~556Automated safety check: PassMIT
Feishu Docopenclaw/openclaw392k—~516Automated safety check: PassMIT
Feishu Docraucvr/Group-Goki1123 repos~592Automated safety check: PassMIT
Feishu Driveraucvr/Group-Goki1123 repos~587Automated safety check: PassMIT
Feishu Permraucvr/Group-Goki1123 repos~630Automated safety check: PassMIT
Feishu Safety GuideSafeAI-Lab-X/ClawKeeper1k—~3.6kAutomated safety check: PassNone

Similar skills

  • Feishu Doc

    openclaw/openclaw

    Feishu document read/write workflows. An agent skill from openclaw/openclaw.

    392k GitHub stars~516 tokensUpdated today
    Productivity & AutomationAuto-check passed
  • Feishu Doc

    raucvr/Group-Goki

    Feishu document read/write operations. An agent skill from raucvr/Group-Goki.

    112 GitHub starsUsed in 3 repos~592 tokens
    Productivity & AutomationAuto-check passed
  • Feishu Drive

    raucvr/Group-Goki

    Feishu cloud storage file management. An agent skill from raucvr/Group-Goki.

    112 GitHub starsUsed in 3 repos~587 tokens
    Productivity & AutomationAuto-check passed
  • Feishu Perm

    raucvr/Group-Goki

    Feishu permission management for documents and files. An agent skill from raucvr/Group-Goki.

    112 GitHub starsUsed in 3 repos~630 tokens
    Productivity & AutomationAuto-check passed
  • Feishu Safety Guide

    SafeAI-Lab-X/ClawKeeper

    One-click deployment Skill for Feishu security governance and message anti-data-leakage guide, responsible for Feishu message security, credential protection, permission auditing, interaction…

    1k GitHub stars~3.6k tokensUpdated 1 mo ago
    Productivity & AutomationAuto-check passed
  • Tlive

    y49/tlive

    tlive — remote approvals (Telegram/Feishu/web), live web terminal, and session monitoring for Claude Code / Codex.

    215 GitHub stars~1.7k tokensUpdated 1 mo ago
    Productivity & AutomationAuto-check: notes

More from smallnest/goclaw

  • Crawl4AI Web Scraping

    smallnest/goclaw

    Scrapes sites, handles JavaScript-heavy pages and extracts structured data with Crawl4AI, through its crwl CLI or Python SDK, including schema-based extraction without an LLM.

    599 GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed
  • Reference for OpenClaw's discord tool: sending messages, reactions, stickers, emoji uploads, polls, threads and moderation in Discord channels and DMs.

    599 GitHub starsUsed in 1 repo~2.9k tokens
    Auto-check passed
  • Looks up action manuals with verified selectors for multi-step website tasks, then drives the browser with the actionbook CLI in a dedicated or an existing Chrome session.

    599 GitHub starsUsed in 1 repo~4.1k tokens
    Auto-check: warnings
  • Controls an Android device over ADB in a loop of screenshot, vision analysis, tap and verification, so the agent acts on real on-screen coordinates.

    599 GitHub stars~436 tokensUpdated 6 mo ago
    Auto-check passed
  • goclaw Skill Finder

    smallnest/goclaw

    Helps you find, install, update and remove skills in the goclaw agent framework, using the goclaw skills commands and outside skill sources.

    599 GitHub stars~1.2k tokensUpdated 6 mo ago
    Auto-check passed

Works with

Questions about Feishu Upload Image

What does Feishu Upload Image do?

Upload images to Feishu/Lark. An agent skill from smallnest/goclaw. Feishu Upload Image is an agent skill from smallnest/goclaw. Upload images to Feishu/Lark.

When should I use Feishu Upload Image?

Feishu Upload Image fits situations like: tasks that involve Messaging and chat bots.

How do I install Feishu Upload Image in Claude Code?

Run `npx skills add smallnest/goclaw --skill feishu-upload-image -a claude-code`. Or copy the skill folder (internal/builtin_skills/feishu-upload-image in smallnest/goclaw) into .claude/skills/feishu-upload-image in your project. Claude Code loads it when a task matches its description.

How do I install Feishu Upload Image in Codex?

Run `npx skills add smallnest/goclaw --skill feishu-upload-image -a codex`. Or copy the skill folder (internal/builtin_skills/feishu-upload-image in smallnest/goclaw) into .agents/skills/feishu-upload-image in your project. Codex loads it when a task matches its description.

Can I use Feishu Upload Image in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add smallnest/goclaw --skill feishu-upload-image -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/feishu-upload-image, .gemini/skills/feishu-upload-image, .github/skills/feishu-upload-image and .opencode/skills/feishu-upload-image in your project.

What does Feishu Upload Image need to run?

Going by SKILL.md and its folder, Feishu Upload Image needs Python for the scripts in its folder and the command-line tools its instructions call (python3 and curl). Our summary lists: Python 3.

Does Feishu Upload Image access the network?

SKILL.md names 1 domain. In commands or code: open.feishu.cn; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Feishu Upload Image safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Feishu Upload Image use?

Feishu Upload Image is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Feishu Upload Image use?

About 556 tokens (SKILL.md is roughly 2.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Feishu Upload Image?

Skills that share tags, products or a category with Feishu Upload Image: Feishu Doc (openclaw/openclaw, 392k stars), Feishu Doc (raucvr/Group-Goki, 112 stars), Feishu Drive (raucvr/Group-Goki, 112 stars) and Feishu Perm (raucvr/Group-Goki, 112 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Feishu Upload Image?

smallnest (a GitHub user) maintains it in smallnest/goclaw, which has 599 GitHub stars. The repository holds 6 skills in this directory. The repository was last updated on March 27, 2026.

Source: smallnest/goclaw on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.