A streamlined utility that converts local image files into permanent, public URLs via Catbox.moe for seamless AI agent workflows.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install upload-to-catbox
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install upload-to-catbox using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Catbox Image Upload Skill?
This skill acts as a bridge between your local file system and cloud-based AI services within the Openclaw Skills ecosystem. It specializes in transforming local image assets into public, permanent URLs by leveraging the Catbox.moe API. This is essential for developers using AI models that require external image links rather than raw local bytes, ensuring that your local data is accessible to web-based processing tools.
The skill provides a zero-configuration solution for image hosting, supporting various formats such as PNG, JPG, GIF, and WebP. It is designed to be lightweight, requiring no login or API keys, and offers permanent storage for uploaded assets, making it a reliable choice for long-term project management and AI-driven image editing tasks.
Catbox Image Upload Skill Use Cases
- Automatically converting local project screenshots into shareable URLs for documentation.
- Preparing local image files for cloud-based AI models like Seedream, Flux, or Sora that only accept URL inputs.
- Streamlining image editing workflows by hosting source images before calling editing APIs.
- Handling image uploads detected within specific project directories like those used in Cursor.
How Catbox Image Upload Skill Works
- The skill monitors for local image paths starting with
/,./, or containing specific project markers like .cursor/projects/. - Upon detection or user request, it initiates a binary file upload to the Catbox.moe API using a curl command.
- The skill captures the plain-text URL returned by the Catbox server.
- The generated URL is then either presented to the user or passed as an input parameter to subsequent Openclaw Skills in a multi-step automation pipeline.
Catbox Image Upload Skill Setup
This skill relies on the standard curl utility. No registration or API keys are required to begin using Catbox.moe through this skill.
# Verify your local curl installation
curl --version
# The skill executes the following command format internally:
curl -F'reqtype=fileupload' -F'fileToUpload=@/path/to/image.png' https://catbox.moe/user/api.php
Catbox Image Upload Skill Data Schema & Taxonomy
The skill processes local file metadata and generates web-hosted pointers as described below:
| Attribute | Description | Constraints |
|---|---|---|
| Input Path | Absolute or relative local path to an image. | Must be < 200MB |
| Supported Formats | png, jpg, jpeg, gif, webp | N/A |
| Output URL | Permanent link to the hosted file. | Protocol: HTTPS |
| Storage Policy | Permanent hosting via catbox.moe. | No auto-deletion |
Catbox Image Upload Skill Advanced Features
- Intelligent path recognition for macOS/Linux home directories and specific IDE project structures.
- Seamless integration with image editing models where the upload happens as a silent pre-processing step.
- Binary upload support to ensure high-fidelity image transfers without the overhead of Base64 encoding.
- Robust error handling for network-sensitive uploads within the Openclaw Skills framework.
SKILL.md
Loading
Related Openclaw Skills
Image Upload Skill
A high-performance utility to convert local images or remote URLs into public cloud-hosted links for AI agent workflows.
Nano Banana Pro Image Generation
A high-performance image generation and editing skill powered by Google's Nano Banana Pro model for photorealistic results.
MiniMax Multi-person Dialogue Speech Synthesis
An advanced AI skill for generating natural multi-character dialogues with intelligent voice matching and high-fidelity speech synthesis.
Frontend Design
A professional-grade design skill that enables AI agents to create distinctive, high-fidelity web interfaces and components that avoid generic AI aesthetics.
Vidu Video Generation
A high-performance AI text-to-video skill powered by Vidu Q3 Pro, capable of generating cinematic videos with synchronized audio.
Wan 2.6 Video Generation
An advanced video generation skill utilizing the Wan 2.6 model to create cinematic content from images and maintain subject consistency using reference videos.
Featured*
