Qiniu Upload for Openclaw

A powerful utility to upload local assets to Qiniu Cloud and retrieve publicly accessible or signed private CDN URLs.

chenggongdu
v0.1.0
Mar 24, 2026
1
711
0

Install & Download

1. ClawHub CLI

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

npx clawhub@latest install qiniu-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 qiniu-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 Qiniu Upload?

The Qiniu Upload tool is a specialized component within the Openclaw Skills ecosystem designed to bridge the gap between local file systems and cloud storage. It automates the process of pushing media, documents, and data to Qiniu Cloud, instantly returning a structured response containing the hosted location and CDN URL.

By leveraging this skill, developers can easily transform local resources into web-accessible assets, making it an essential building block for cloud-native applications. Whether you are managing static assets or preparing files for high-speed delivery, these Openclaw Skills provide a reliable interface for Qiniu's robust storage infrastructure.

Qiniu Upload Use Cases

  • Converting local media files into CDN-hosted URLs for web application access.
  • Preparing audio or video files for downstream AI processing such as speech-to-text or computer vision.
  • Automating cloud backups of generated local reports or logs via Openclaw Skills.
  • Generating time-limited, signed private URLs for secure content distribution.

How Qiniu Upload Works

  1. The skill validates the existence of the local file path provided by the user.
  2. It checks for the presence of required Qiniu environment variables to ensure secure authentication.
  3. The file is streamed to the specified Qiniu bucket using the configured zone and prefix.
  4. Upon successful upload, the skill generates either a public CDN URL or a signed private URL based on the user's flags.
  5. A structured JSON response is returned, allowing for seamless integration into complex Openclaw Skills pipelines.

Qiniu Upload Setup

To get started with this skill, configure your environment variables and use the following command structure:

# Set required environment variables
export QINIU_ACCESS_KEY="your_access_key"
export QINIU_SECRET_KEY="your_secret_key"
export QINIU_BUCKET="your_bucket_name"
export QINIU_DOMAIN="your_cdn_domain"

# Run the upload script
node scripts/upload.js --file-path "/path/to/file.mp3" --prefix uploads

Qiniu Upload Data Schema & Taxonomy

The skill returns a comprehensive data object for every successful operation:

Property Type Description
success Boolean Indicates if the upload was successful.
bucket String The target Qiniu bucket name.
key String The unique object key in the cloud storage.
url String The final accessible CDN or private signed URL.
isPrivate Boolean Reflects if the URL requires authentication.
size Number File size in bytes.
mimeType String The detected MIME type of the uploaded file.

Qiniu Upload Advanced Features

  • Support for signed private URLs with customizable expiry times (--expire-seconds).
  • Granular object key control using prefixes or explicit naming conventions.
  • Machine-friendly JSON output mode for automated CLI piping.
  • Seamless chaining capabilities with other Openclaw Skills for end-to-end media processing workflows.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*