openclaw-skill-r2-storage_skill

Overview

This skill manages Cloudflare R2 object storage using the S3-compatible boto3 API. It provides upload, download, list, delete, and pre-signed URL operations accessible via a CLI or as an importable Python module. It is designed for backups, asset hosting, and automated storage workflows.

How this skill works

The skill wraps boto3 S3 client calls configured for R2 (region_name="auto" and a custom endpoint). It reads credentials and endpoint from environment variables, constructs requests for put/get/list/delete operations, and can generate temporary GET pre-signed URLs. CLI entrypoints mirror the Python functions for easy scripting and ad-hoc use.

When to use it

• Upload backups, media, or static assets to Cloudflare R2
• Download stored objects for restore or local processing
• List bucket contents to inventory or iterate objects
• Remove obsolete or test objects to reclaim space
• Generate temporary public download links for sharing

Best practices

• Set credentials via environment variables and avoid hard-coding keys
• Use prefixes to scope list and delete operations to specific folders
• Limit pre-signed URL expiry to the minimum needed for security
• Use multipart uploads for very large files (handled via boto3 patterns)
• Validate uploaded object integrity by checking size or checksums

Example use cases

• Automated nightly backup upload to an R2 bucket via the CLI or a cron job
• Fetch and process media files from R2 in a Python ETL script using download()
• List files under a prefix to build a static site manifest or sync tool
• Create a one-hour pre-signed URL to share a private asset with a client
• Delete build artifacts from a bucket after a CI job completes