PixelVault Upload for Openclaw

Automatically upload images, screenshots, and diagrams to PixelVault and retrieve lightning-fast CDN URLs for immediate sharing.

facundofarias
v1.0.0
Jul 4, 2026
0
355
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install pixelvault-upload

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install pixelvault-upload 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 PixelVault Upload?

The PixelVault Upload skill empowers AI agents to seamlessly host images, screenshots, and visual assets on a global CDN. By integrating this capability, your agent can instantly convert local image generation, mockups, or diagrams into accessible, public-facing links. This bridge is essential when automating workflows that require embedding media directly into GitHub pull requests, issue trackers, and customer communication channels.

Optimized for developer workflows, this is one of the most practical Openclaw Skills for visual data management. It minimizes local storage constraints and removes manual upload hurdles, allowing agents to deliver polished, media-rich outputs on demand.

PixelVault Upload Use Cases

  • Hosting screenshots or diagrams generated during a development workflow.
  • Sharing UI mockups directly with team members or clients within comments.
  • Embedding visual build artifacts or test output captures into GitHub PRs and issues.
  • Offloading local image storage to a globally distributed and highly cached CDN.

How PixelVault Upload Works

  1. CLI Verification: The system checks if the pixelvault CLI is installed locally by running which pixelvault.
  2. Authentication Verification: Runs authorization checks via the pixelvault whoami --json command to ensure the configured API key is valid.
  3. Asset Processing: Identifies single files or batch files matching specified files or glob patterns (e.g., ./images/*.jpg).
  4. Secure Upload: Executes the CLI upload command, specifying optional target folders for structural organization.
  5. Response Handling: Captures the generated CDN URLs from stdout and parses metadata if --json is specified.
  6. URL Reporting: Delivers the public CDN links back to the user or integrates them into downstream markdown documents.

PixelVault Upload Setup

First, install the PixelVault command-line interface globally:

npm install -g pixelvault-cli

Next, configure your API credentials. You can either execute the setup assistant or export your API key environment variable:

# Configure using the built-in assistant
/pixelvault-setup

# Or manually set your API key environment variable
export PIXELVAULT_API_KEY="your-api-key-here"

PixelVault Upload Data Schema & Taxonomy

The PixelVault Upload skill operates on parameters provided during invocation. The CLI supports standard single-file paths as well as standard directory glob patterns.

Inputs

Argument Type Required Description
files String Yes File path or glob pattern (e.g., screenshot.png, ./images/*.jpg)
folder String No Target folder directory within your PixelVault container for file organization

Response Schema (JSON Mode)

When querying metadata with the --json option, the CLI returns a structured JSON payload:

Attribute Type Description
id String Unique resource identifier for the uploaded asset
url String Globally cached public CDN URL
size Number File size in bytes
mime_type String The detected MIME type of the uploaded image
filename String Original source filename

PixelVault Upload Advanced Features

  • Shell Globbing: Support for bulk uploads utilizing native shell globbing patterns (e.g., uploading ./assets/*.png).
  • JSON Metadata Parsing: Option to output complete resource metadata to extract deep properties like MIME type, original file size, and unique IDs.
  • Modular Folders: Dynamic organizational nesting to prevent namespace collisions and segregate assets across multiple environments.
  • Resilient Error Architecture: Built-in mapping for common REST exceptions including payload size limits (5MB free/50MB paid tiers) and media type assertions.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*