ClawHub

Markdown 图片直传 R2

Other

Upload local images in Markdown directly to Cloudflare R2 and replace paths with public URLs.

Install

openclaw skills install md-img-r2

md-img-r2

将 Markdown 文件中的本地图片直接上传到 Cloudflare R2，并把本地路径替换为公开 URL。

适用场景

  • 你已经有 Cloudflare R2 桶和可公开访问域名
  • 你不想依赖 PicList Desktop
  • 你希望把这个能力作为可分发 skill 交给别人使用

前置条件

  1. 已有可写入的 Cloudflare R2 凭证
  2. 已有桶名和公开访问域名或 CDN 域名
  3. 运行环境有 python3

推荐配置

优先用环境变量或项目根目录的 .env 提供配置：

  • CF_R2_ACCOUNT_ID
  • CF_R2_ACCESS_KEY_ID
  • CF_R2_SECRET_ACCESS_KEY
  • CF_R2_BUCKET
  • CF_R2_PUBLIC_BASE_URL
  • CF_R2_REGION，默认 auto
  • CF_R2_ENDPOINT，默认 https://<account_id>.r2.cloudflarestorage.com
  • CF_R2_KEY_PREFIX，默认 md-assets
  • --env-file 可显式指定 .env 路径；不传时会优先读取 skill 目录下的 .env，再从目标目录向上查找

用法

单文件

bash run.sh path/to/article.md

目录批处理

bash run.sh path/to/dir --recursive

Dry run

bash run.sh path/to/article.md --dry-run

临时覆盖 key 前缀

bash run.sh path/to/article.md --key-prefix posts/2026-04

输出

  • 默认原地修改，并生成备份：xxx.md.bak
  • 生成报告：xxx.md.replace-report.json