使用说明

S3 Storage Skill 为 Agent 提供对象存储操作能力，兼容 AWS S3、MinIO、Cloudflare R2 等所有 S3 协议存储服务。

clawhub install s3-storage

核心功能

文件上传：单文件和多文件上传，支持自动 MIME 类型检测
文件下载：支持断点续传和流式下载
列举和搜索：按前缀、扩展名筛选对象
删除操作：单文件和批量删除
预签名 URL：生成临时访问链接，无需暴露凭据
元数据管理：设置和读取对象元数据和标签

配置

export S3_ENDPOINT=https://s3.amazonaws.com
export S3_REGION=us-east-1
export S3_ACCESS_KEY=AKIAIOSFODNN7EXAMPLE
export S3_SECRET_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
export S3_BUCKET=my-bucket

MinIO / R2 用户只需修改 S3_ENDPOINT。

使用示例

把本地的 report.pdf 上传到 s3://my-bucket/reports/

列出 bucket 里所有 .csv 文件

生成一个 1 小时有效的下载链接

适用场景

日志归档和备份
静态资源托管
数据导入导出中转
文件分享（预签名 URL）

注意事项

大文件（>100MB）建议用分片上传
预签名 URL 的过期时间不宜过长
R2 不收出口流量费，适合高频下载场景
生产环境用 IAM Role 而非硬编码 Access Key

使用说明

S3 Storage Skill 为 Agent 提供对象存储操作能力，兼容 AWS S3、MinIO、Cloudflare R2 等所有 S3 协议存储服务。

clawhub install s3-storage

核心功能

文件上传：单文件和多文件上传，支持自动 MIME 类型检测
文件下载：支持断点续传和流式下载
列举和搜索：按前缀、扩展名筛选对象
删除操作：单文件和批量删除
预签名 URL：生成临时访问链接，无需暴露凭据
元数据管理：设置和读取对象元数据和标签

配置

export S3_ENDPOINT=https://s3.amazonaws.com
export S3_REGION=us-east-1
export S3_ACCESS_KEY=AKIAIOSFODNN7EXAMPLE
export S3_SECRET_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
export S3_BUCKET=my-bucket

MinIO / R2 用户只需修改 S3_ENDPOINT。

使用示例

把本地的 report.pdf 上传到 s3://my-bucket/reports/

列出 bucket 里所有 .csv 文件

生成一个 1 小时有效的下载链接

适用场景

日志归档和备份
静态资源托管
数据导入导出中转
文件分享（预签名 URL）

注意事项

大文件（>100MB）建议用分片上传
预签名 URL 的过期时间不宜过长
R2 不收出口流量费，适合高频下载场景
生产环境用 IAM Role 而非硬编码 Access Key