Awsclaw S3 File Operations

Upload and download files and folders to/from S3 with folder structure preservation.

When to Use This Skill

Use this skill when the user:

• Wants to upload one or multiple files to S3
• Wants to download one or multiple files from S3
• Needs to upload entire folders to S3 preserving directory structure
• Needs to download entire S3 prefixes/folders to local disk
• Asks about bulk file transfers to/from S3

Tool: S3FileOperationsTool

Execute S3 file operations for bulk transfers. ALWAYS provide params object.

Commands

UploadFile

Upload one or multiple local files to S3.

{
  "command": "UploadFile",
  "params": {
    "Bucket": "my-bucket",
    "LocalPaths": ["/path/to/file1.txt", "/path/to/file2.csv"],
    "S3KeyPrefix": "uploads/",
    "ContentType": "text/plain"
  }
}

Parameters:

DownloadFile

Download one or multiple files from S3 to a local directory.

{
  "command": "DownloadFile",
  "params": {
    "Bucket": "my-bucket",
    "S3Keys": ["data/file1.csv", "data/file2.csv"],
    "LocalDirectory": "/path/to/local/dir"
  }
}

Parameters:

UploadFolder

Upload local folders to S3 with preserved directory structure.

{
  "command": "UploadFolder",
  "params": {
    "Bucket": "my-bucket",
    "LocalPaths": ["/path/to/local/folder"],
    "S3KeyPrefix": "backups/",
    "PreserveStructure": true
  }
}

Parameters:

DownloadFolder

Download entire S3 prefixes/folders to local disk with preserved structure.

{
  "command": "DownloadFolder",
  "params": {
    "Bucket": "my-bucket",
    "S3KeyPrefixes": ["data/2024/", "data/2025/"],
    "LocalDirectory": "/path/to/local/dir",
    "PreserveStructure": true
  }
}

Parameters:

Related Services

• S3Tool: For object-level operations (list, get, put, delete, copy), bucket configuration, S3 Select queries, and S3 Explorer — see the awsclaw-s3 skill
• Lambda: Lambda functions commonly read/write S3 objects
• Glue: Glue crawlers catalog S3 data, ETL jobs process S3 files
• CloudFormation: S3 buckets and their configurations managed via stacks