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)

Variable	Description
R2_ACCESS_KEY_ID	Cloudflare R2 access key
R2_SECRET_ACCESS_KEY	Cloudflare R2 secret key
R2_ACCOUNT_ID	Cloudflare account ID (default: 851741409acd69e96d6c480584a3c107)
R2_BUCKET_NAME	R2 bucket name (default: openclaw-images)
R2_PUBLIC_DOMAIN	Public domain (default: https://pub-406cc49bf2114c608757721fa88725fa.r2.dev)

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