← 返回 Skills 市场
327
总下载
1
收藏
1
当前安装
4
版本数
在 OpenClaw 中安装
/install imgbb-api
功能描述
Upload images to ImgBB via local file, URL, or base64 and get shareable direct links, supporting batch uploads and optional expiration settings.
使用说明 (SKILL.md)
ImgBB API
Upload images to ImgBB and get shareable URLs.
When This Skill Activates
This skill triggers when user wants to upload images to the web for sharing.
Reasoning Framework
| Step | Action | Why |
|---|---|---|
| 1 | CHECK | Verify API key is available |
| 2 | PREPARE | Get image path or URL |
| 3 | UPLOAD | Send to ImgBB API |
| 4 | RETURN | Return shareable URL |
Setup
export IMGBB_API_KEY="your_api_key_here"
# or
echo "your_api_key" > ~/.imgbb_api_key
Get API Key
- Go to https://api.imgbb.com/
- Click "Get API Key"
- Copy your API key
Decision Tree
├── Upload single image → python imgbb.py image.jpg
├── Upload from URL → python imgbb.py --url "URL"
├── Custom name → python imgbb.py image.jpg --name myimg
├── Set expiration → python imgbb.py image.jpg --expiration 3600
├── Batch upload → python imgbb.py --batch ./folder/
└── JSON output → python imgbb.py image.jpg --json
Usage
# Upload file
python imgbb.py image.jpg
# With custom API key
python imgbb.py image.jpg --key YOUR_KEY
# From URL
python imgbb.py --url "https://..."
# Batch upload
python imgbb.py --batch ./folder/
# JSON output
python imgbb.py image.jpg --json
Options
| Flag | Description |
|---|---|
image |
Path to image |
--key |
API key |
--url |
Upload from URL |
--name |
Custom name |
--expiration |
Expiry seconds |
--json |
JSON output |
--batch |
Batch folder |
--set-key |
Save API key |
Troubleshooting
No API key found
- Fix: Set
IMGBB_API_KEYenv or use--key
File not found
- Fix: Check file path is correct
Invalid image format
- Fix: Use JPG, PNG, GIF, or WEBP
Image too large
- Fix: Compress under 32MB
Quick Reference
| Task | Command |
|---|---|
| Upload | python imgbb.py image.jpg |
| URL | python imgbb.py --url "URL" |
| Batch | python imgbb.py --batch ./folder/ |
| JSON | python imgbb.py image.jpg --json |
安全使用建议
This skill appears to do exactly what it says: upload images to ImgBB. Before installing, be aware that it expects an ImgBB API key (IMGBB_API_KEY or supplied via --key) and can save that key to ~/.imgbb_api_key if you use --set-key. The registry metadata omits the declared env requirement (IMGBB_API_KEY) — check that you provide the key securely and only give the key needed for ImgBB. If you prefer not to store the key on disk, pass it per-run with --key or via an environment variable.
功能分析
Type: OpenClaw Skill
Name: imgbb-api
Version: 1.1.2
The skill bundle is a legitimate implementation of an ImgBB API client for uploading images. The Python script (scripts/imgbb.py) uses the standard 'requests' library to interact with the official ImgBB API endpoint and handles API keys through environment variables or a local configuration file (~/.imgbb_api_key) without any signs of data exfiltration, malicious execution, or prompt injection.
能力评估
Purpose & Capability
The name, description, SKILL.md, and scripts/imgbb.py all consistently implement an ImgBB uploader. The only mismatch is registry metadata (which lists no required env vars or binaries) vs SKILL.md and the script that expect python3, the requests library, and an IMGBB_API_KEY — the code legitimately needs those.
Instruction Scope
Runtime instructions and the script stay within the stated purpose: they read an API key (env or ~/.imgbb_api_key), accept a local file/URL/base64, and POST to https://api.imgbb.com/1/upload. There are no instructions to collect unrelated files, scan the system, or exfiltrate data to unexpected endpoints.
Install Mechanism
This is an instruction-only skill with an included Python script (no installer). SKILL.md indicates python3 and the requests pip package are required — reasonable for this task. There is no external download URL or archive extraction; risk from install mechanism is low.
Credentials
The only secret the skill uses is an ImgBB API key provided via IMGBB_API_KEY, --key, or a local config file (~/.imgbb_api_key). That is proportionate to an image-uploading tool. The minor issue: registry metadata does not declare IMGBB_API_KEY while SKILL.md and code do, which is an inconsistency callers should be aware of.
Persistence & Privilege
The skill does not request persistent platform privileges. It can optionally write a small config file to the user's home (~/.imgbb_api_key) when --set-key is used — this is limited in scope and expected for convenience. always is false and the skill does not modify other skills or system-wide settings.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install imgbb-api - 安装完成后，直接呼叫该 Skill 的名称或使用
/imgbb-api触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.1.2
- Added "requests" to the required Python packages in the setup metadata.
- No changes to user-facing functionality or interface.
v1.1.1
- Patch update with internal changes to scripts/imgbb.py.
- No changes to documentation or public API.
- Version bumped to 1.1.1.
v1.1.0
v1.1.0: Added guidance and troubleshooting for easier use
- Introduced reasoning framework and step-by-step decision tree for uploading images.
- Added troubleshooting section to address common issues (API key, file errors, size limits).
- Updated options and quick reference tables for clearer usage.
- Improved documentation with explicit activation and API key setup guidance.
v1.0.0
Initial release – upload images to ImgBB and obtain shareable direct URLs.
- Supports uploading from local files, URLs, and Base64 data.
- Offers bulk image upload and custom expiration for uploads.
- Multiple authentication methods: command-line flag, environment variable, or config file.
- Returns useful response fields like direct link, viewer link, thumbnail, and delete link.
- Python script includes options for naming, batch upload, JSON output, and more.
元数据
常见问题
ImgBB API 是什么？
Upload images to ImgBB via local file, URL, or base64 and get shareable direct links, supporting batch uploads and optional expiration settings. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 327 次。
如何安装 ImgBB API？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install imgbb-api」即可一键安装，无需额外配置。
ImgBB API 是免费的吗？
是的，ImgBB API 完全免费（开源免费），可自由下载、安装和使用。
ImgBB API 支持哪些平台？
ImgBB API 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 ImgBB API？
由 KeXu9（@kexu9）开发并维护，当前版本 v1.1.2。
推荐 Skills