cloudflare-r2

What This Skill Does

The cloudflare-r2 skill enables OpenClaw to interact directly with your Cloudflare R2 storage buckets using the Wrangler CLI. This provides a streamlined interface for file management, allowing you to upload, list, and delete assets stored in the cloud. By integrating this skill, OpenClaw can act as an automated asset manager for your web projects, handling everything from deploying individual images to managing large collections of files intended for CDN delivery. It bridges the gap between local file systems and globally distributed storage by providing standardized shell-based automation wrappers that simplify the complex Wrangler CLI commands required for R2 operations.

Installation

To integrate this skill into your OpenClaw environment, ensure you have the Wrangler CLI installed globally via npm install -g wrangler. Next, create a configuration file at ~/.config/cloudflare/r2.json containing your bucket name, account ID, public domain, and API token. Once configured, execute clawhub install openclaw/skills/skills/dongsjoa-byte/cloudflare-r2 to add the skill to your agent. Ensure your system environment variables have the necessary permissions to execute the provided shell scripts, as the skill relies on internal calls to scripts/r2-upload.sh.

Use Cases

This skill is perfect for developers managing static site assets, content creators looking to host videos or media files on a high-performance CDN, and system administrators automating the backup of configuration files or logs. For instance, if you are generating blog post assets, you can instruct OpenClaw to upload your processed images to the R2 bucket and immediately return the public URL for your content. It is also highly efficient for batch uploads, allowing you to sync entire folders of built static assets directly to your public R2 bucket in a single command.

Example Prompts

1. "Upload the file 'banner.png' in my current folder to the R2 bucket under the folder 'marketing/' and give me the public link."
2. "I need to deploy all contents from the 'dist/' folder to the 'production/' prefix in my configured R2 bucket."
3. "List all files currently in the 'archives/' folder of my R2 bucket so I can see what is available for deletion."

Tips & Limitations

To maximize effectiveness, always ensure your apiToken has sufficient permissions for R2 write and list access. Remember that R2 storage is object-based, so verify your prefixes match your expected file structure to avoid clutter. The skill uses shell-level execution, so always sanitize input paths if passing dynamic variables from user inputs to prevent unauthorized file access. Currently, this skill only supports authenticated operations via the local wrangler configuration, so ensure your machine has internet access to communicate with Cloudflare's API endpoints.