r2-upload

name: r2-upload description: Upload files (images, documents) to Cloudflare R2 and get a public URL. Use when you need to host/share an image or file publicly. metadata: { "openclaw": { "emoji": "☁️", "os": ["linux", "macos"], "requires": { "bins": ["python3"] }, "env": ["R2_ACCESS_KEY_ID", "R2_SECRET_ACCESS_KEY"] }

}

R2 Upload — Cloudflare R2 File Hosting

Upload images and files to Cloudflare R2 storage and get a permanent public URL.

When to use

• When you need to host an image and share the public URL
• When you generated an image and want to send it in chat (Telegram, Zalo, etc.)
• When you need to store files permanently in the cloud

Environment Variables (Required)

Option A: Python (recommended, auto-installs boto3)

python3 /app/skills/r2-upload/scripts/upload.py /path/to/image.jpg

Upload with custom key:

python3 /app/skills/r2-upload/scripts/upload.py /path/to/photo.png --key "agents/my-photo.png"

Upload from URL:

python3 /app/skills/r2-upload/scripts/upload.py "https://example.com/image.jpg"

Option B: Node.js (requires @aws-sdk/client-s3)

First install (one-time):

cd /app/skills/r2-upload/scripts && npm install @aws-sdk/client-s3

Then upload:

node /app/skills/r2-upload/scripts/upload.js /path/to/image.jpg

Output

✅ Upload success!
URL: https://pub-406cc49bf2114c608757721fa88725fa.r2.dev/image.jpg

Important Notes

• Max file size: 300MB (R2 free tier)
• Files are publicly accessible once uploaded
• Duplicate filenames are overwritten — use --key for unique paths
• To change bucket/domain: set R2_BUCKET_NAME and R2_PUBLIC_DOMAIN env vars