A secure and efficient tool for managing Aliyun Object Storage Service (OSS) uploads and generating temporary access links.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install aliyun-oss
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 aliyun-oss 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 Aliyun OSS File Upload?
This skill provides a robust interface for interacting with Aliyun Object Storage Service (OSS), designed specifically to enhance the file handling capabilities of your agent within the Openclaw Skills ecosystem. It facilitates high-performance file transfers, including multipart uploads for large datasets, while maintaining strict security through AccessKey/SecretKey authentication and external configuration management. By using this tool, developers can automate cloud storage workflows and generate secure, time-limited sharing links directly from their AI agent environment.
Built with production readiness in mind, it follows strict security best practices, including the use of RAM users and minimal permission sets. Whether you are handling single assets or batch processing thousands of files, this skill ensures that your data is moved reliably to the cloud with full support for custom storage paths and automated renaming to prevent filename collisions.
Aliyun OSS File Upload Use Cases
- Automating the upload of local assets to Aliyun OSS during development workflows.
- Generating secure, temporary download links for shared resources in a chat environment.
- Handling large file transfers up to 2GB using automated multipart upload logic.
- Organizing project files into specific cloud directories and buckets for better asset management.
- Searching for existing cloud assets via CLI or agent commands within the Openclaw Skills framework.
How Aliyun OSS File Upload Works
- The skill initializes by reading secure credentials and bucket metadata from a localized JSON configuration file.
- Users or agents trigger an upload, batch upload, or search command via the provided Python interface.
- The system evaluates the file size; files exceeding the 100MB threshold are automatically processed via multipart upload for stability.
- Upon successful transfer, the tool can generate a pre-signed URL with a custom expiration period (e.g., 1 hour to 7 days).
- The generated links and status reports are then returned to the Openclaw Skills environment for immediate use or sharing.
Aliyun OSS File Upload Setup
First, create the required configuration file at /root/.openclaw/aliyun-oss-config.json with your specific Aliyun credentials:
{
"endpoint": "oss-cn-shanghai.aliyuncs.com",
"bucket_name": "your-bucket-name",
"auth": {
"access_key_id": "your-access-key-id",
"access_key_secret": "your-access-key-secret"
},
"max_file_size_mb": 2048,
"default_expire_hours": 0.5,
"large_file_threshold_mb": 100,
"default_prefix": "uploads/"
}
Ensure you have Python 3 installed and then run the following to upload a file:
# Upload a single file
python3 main.py upload /path/to/file.txt uploads/
# Batch upload multiple files
python3 main.py batch_upload file1.txt file2.txt uploads/
Aliyun OSS File Upload Data Schema & Taxonomy
The skill manages its operations through a combination of local configuration and remote bucket metadata. Below is the primary schema for the configuration and output results.
| Attribute | Description | Data Type |
|---|---|---|
| endpoint | The Aliyun OSS region endpoint | String |
| bucket_name | The target storage bucket name | String |
| access_key_id | RAM user identification key | String |
| max_file_size_mb | Hard limit for file uploads (max 2048) | Integer |
| sign_url | The generated pre-signed temporary link | URL String |
| default_prefix | The default directory path in the bucket | String |
Aliyun OSS File Upload Advanced Features
- Automatic multipart upload for files exceeding 100MB to ensure reliable transfers for large datasets.
- Custom link expiration settings ranging from 30 minutes to 7 days for enhanced security control.
- File collision prevention using UUID or timestamp-based automatic renaming strategies.
- Seamless integration with the Openclaw Skills media processing pipelines for automated storage triggers.
- Advanced error handling and retry mechanisms built on the oss2 SDK for resilient network performance.
SKILL.md
Loading
Related Openclaw Skills
Aliyun Mail
A professional-grade skill for automating enterprise email communication through Aliyun with full support for Markdown, attachments, and syntax highlighting.
Resume Project Summarizer
An intelligent assistant that converts fragmented project experiences into structured, job-specific resumes using industry-standard frameworks like STAR.
Qwen3-TTS Local Inference
A high-performance local Python engine for generating speech, designing voices, and cloning audio using Qwen3-TTS without external API dependencies.
MongoDB Document Storage
A powerful MongoDB interface for AI agents to perform persistent document storage and complex data operations via a simple CLI.
WeChat Search Skill
A specialized search utility for discovering and extracting metadata from WeChat Official Account articles using a compliant, multi-layered approach.
WeChat Search
A multi-layered search tool for retrieving WeChat Official Account articles through compliant APIs and intelligent fallbacks.
Featured*
