upload-to-catbox

What This Skill Does

The upload-to-catbox skill is a specialized utility for the OpenClaw AI agent designed to bridge the gap between local file systems and web-based AI tools. Since many advanced AI models (such as image generators, editors, and vision-based agents) require image inputs to be provided via public HTTP(S) URLs rather than local file paths, this skill serves as an automated intermediary. It performs a direct HTTP POST request to the catbox.moe image hosting service, instantly converting any local file—such as a screenshot, photograph, or design asset—into a permanent, publicly accessible URL. This facilitates seamless image processing workflows, ensuring that your local data can be utilized by external model APIs without manual intervention.

Installation

You can install this skill directly via the ClawHub CLI using the following command: clawhub install openclaw/skills/skills/hexiaochun/upload-to-catbox

Use Cases

• Automated Image Editing: When a user requests to change the background or style of a photo stored on their hard drive, this skill automatically prepares the file for the editing engine.
• Vision Model Input: When using AI models that require visual context (like OCR or image analysis tools), this skill extracts the local file and generates the necessary link for the model to access the image content.
• Collaborative Sharing: Quickly converting local screenshots into shareable links for communication or documentation purposes.
• Direct Uploading: Providing a simplified interface for users to backup or host images on a stable, long-term cloud storage service.

Example Prompts

1. "Upload this screenshot /Users/dev/debug_trace.png to catbox for me."
2. "Can you change the background of this local image /home/user/photo.jpg to a professional office setting?"
3. "Please host my image at ./project-assets/banner.png on a public link so I can share it with my team."

Tips & Limitations

• File Limits: The service supports files up to 200MB. Ensure your images are within this limit to prevent failures.
• Performance: While Catbox is fast, network latency may cause a short delay in the AI's response time during the upload process.
• Privacy: Be aware that uploaded files are stored publicly on catbox.moe. Do not upload sensitive or private information using this tool.
• Consistency: If the upload fails due to network issues, the skill is designed to allow retries, ensuring that your core image processing tasks can eventually proceed using the returned URL.