qiniu-upload

What This Skill Does

The qiniu-upload skill provides a robust interface for OpenClaw agents to manage cloud-based file storage using Qiniu Cloud. By automating the transfer of local files to a configured Qiniu bucket, this tool bridges the gap between local storage and cloud-accessible resources. It handles the complexities of authentication, bucket management, and URL generation, ensuring that local files become available for downstream processing. Whether you are moving audio files for transcription, hosting images for a web project, or archiving data, this skill ensures a secure and verifiable upload process.

Installation

To install this skill, use the following command in your terminal: clawhub install openclaw/skills/skills/chenggongdu/qiniu-upload

Ensure that you have your environment variables defined in your OpenClaw configuration file (QINIU_ACCESS_KEY, QINIU_SECRET_KEY, QINIU_BUCKET, QINIU_DOMAIN). Failure to set these required variables will result in the skill failing at runtime.

Use Cases

• Cloud-Ready Media Processing: Upload large audio or video files from local storage to your Qiniu bucket to provide a stable URL for AI transcription services like Aliyun.
• Data Archiving: Automatically move logs or reports generated locally into a cloud bucket for long-term storage and compliance.
• Content Distribution: Prepare assets (images, CSS, scripts) locally and push them to your CDN-backed Qiniu bucket for production use.
• Private File Sharing: Utilize the optional private URL signing feature to share sensitive files securely with time-limited access.

Example Prompts

1. "Upload my local recording E:\audio\interview.mp3 to Qiniu and give me the URL so I can transcribe it."
2. "Take the file at C:\exports\data.csv and upload it to the reports folder on Qiniu using a private, expiring link."
3. "Please move the image at ./logo.png to my Qiniu bucket and return the public CDN link."

Tips & Limitations

• Credential Security: Never hardcode credentials in your prompts. Use environment variables defined in your system setup.
• Connectivity: Ensure your machine has active internet access to communicate with the Qiniu API endpoints.
• Verification: Remember that successful upload does not guarantee public accessibility if your bucket is set to private. Always verify your bucket permissions and use the --private flag if necessary to generate signed tokens.
• File Paths: Always use absolute paths or verify the existence of the file before invoking the command to prevent runtime errors. The skill verifies path existence before initiating the transfer to ensure reliability.