Qiniu Object Storage for Openclaw

A dedicated skill for AI agents to upload local files to Qiniu Object Storage and retrieve secure, shareable delivery links.

showtimewalker
v1.0.0
Apr 4, 2026
0
783
0

Install & Download

1. ClawHub CLI

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

npx clawhub@latest install qiniu-object-storage

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-object-storage 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 Object Storage?

The Qiniu Object Storage skill is designed to manage the final stage of content workflows by bridging local file systems with cloud storage. It allows AI agents to handle file persistence and distribution by uploading assets to Qiniu OSS and returning accessible URLs. This skill is particularly useful for delivering AI-generated media like images, videos, or audio files directly to users.

By leveraging this component of Openclaw Skills, developers can automate the conversion of local file paths into standardized cloud URLs. It intelligently handles both public buckets and private spaces requiring signed links, ensuring that security and accessibility are maintained according to the project's requirements.

Qiniu Object Storage Use Cases

  • Uploading locally generated images or videos to Qiniu OSS for cloud distribution.
  • Generating time-sensitive signed URLs for secure file sharing from private buckets.
  • Automating the delivery phase of a multi-step AI content generation workflow.
  • Organizing project assets into structured cloud directories based on date and file type.

How Qiniu Object Storage Works

  1. The AI agent identifies a local file path that needs to be made accessible online.
  2. The skill automatically parses the file extension to categorize it into images, videos, audio, or other assets.
  3. A unique object key is generated using a structured format: date/type/filename.
  4. The file is uploaded to the configured Qiniu bucket using authenticated credentials.
  5. Depending on the environment configuration, the skill generates either a direct public URL or a signed private URL.
  6. The operation returns a comprehensive JSON response containing the delivery URL and storage metadata.

Qiniu Object Storage Setup

To use this skill within the Openclaw Skills framework, you must configure the following environment variables:

Variable Description
QINIU_ACCESS_KEY Your Qiniu Access Key (Primary identifier)
QINIU_SECRET_KEY Your Qiniu Secret Key
QINIU_BUCKET The name of your storage bucket
QINIU_PUBLIC_DOMAIN The domain used for public access
QINIU_IS_PRIVATE Set to true for private buckets (default: false)

Installation requires uv and Python. Run the upload script using the following command structure:

uv run --python python scripts/upload_file.py --file <path_to_local_file>

Qiniu Object Storage Data Schema & Taxonomy

The skill returns a JSON object with the following structure to ensure compatibility across different agent workflows:

Key Type Description
storage_provider String Always set to qiniu
bucket String The target bucket name
object_key String The path in the bucket (e.g., 20260327/images/photo.png)
access_mode String Either public or private
delivery_url String The final accessible URL for the file
expires_in Integer (Optional) Expiration time for private links in seconds

Qiniu Object Storage Advanced Features

  • Automatic object key generation based on date and content type for better organization.
  • Support for forcing public or private URL generation using --public-url or --private-url flags.
  • Configurable expiration times for signed URLs to enhance security for sensitive documents.
  • Built-in type detection to automatically sort files into images, videos, or audio subdirectories.
  • Seamless integration as a delivery hook for any media-generation agent within the Openclaw Skills ecosystem.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*