AIOS File Transfer

通过S3兼容协议为AI Agent处理文件上传下载

开发流程 智能体开发后端开发运维工程师 通过S3协议传输文件 通用 ★ 845 更新于 2026-07-31

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:AIOS File Transfer。
它的用途是:通过S3兼容协议为AI Agent处理文件上传下载
完整的 Skill 内容见:https://321skill.com/skills/aios-file-transfer-x-2/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

'请将当前工作区中的 report.csv 上传到输出目录,并生成 file_output 链接供下游使用。' 它会自动调用 AIOS File Transfer 将文件上传到配置的 S3 存储,并返回类似 `file_output://agent123/report.csv` 的 URI。随后你可再用该 URI 让另一个 Agent 下载并处理。

介绍

AIOS File Transfer 解决了 AI Agent 在运行过程中需要访问外部文件的问题。当 Agent 收到 file_input://... 格式的 URI 时,它能自动根据当前 senderId 将输入文件从远程 S3 兼容存储下载到本地工作区;当 Agent 需要将本地文件输出时,它又能将当前 senderId 目录内的文件上传到远端,并生成 file_output://... 格式的 URI 供后续流程使用。这样一来,Agent 无需关心底层存储实现,只需通过标准 URI 即可完成文件的读写交换。

使用方式非常简单:你只需在 Agent 的配置中指定兼容 AWS S3 的存储端点(如 MinIO、Ceph 等),并设置好 Access Key 和 Secret Key。之后,当 Agent 需要处理文件时,会自动调用该 Skill 完成传输。无需手动编写 SDK 调用代码,也无需在 Agent 逻辑中混入文件传输细节。

本 Skill 最适合那些基于 OpenClaw 或 AIOS 框架开发智能体应用的开发者,尤其是需要批量处理文件、跨系统交换数据或构建自动化工作流的场景。例如,智能体读入外部 CSV 数据进行分析,或将处理结果以文件形式输出给下游系统。

建议在使用前确保存储桶权限和网络连通性,并注意 senderId 的隔离机制——每个发送者拥有独立的文件目录,避免不同任务间的文件冲突。对于高并发场景,可以搭配 S3 兼容存储的限流和重试机制使用。

核心特点

与其他文件传输工具不同,AIOS File Transfer 深度集成到 AI Agent 的 URI 协议中,Agent 只需识别 `file_input://` 和 `file_output://` 即可自动完成上传下载,无需手动管理文件路径或调用存储 API。

注意事项

依赖兼容 AWS S3 的存储服务,无法直接用于本地文件系统或非 S3 协议的对象存储。

常见问题

支持哪些 S3 兼容存储?

支持所有兼容 AWS S3 协议的对象存储,如 MinIO、Ceph、阿里云 OSS、华为云 OBS 等。

如何配置存储端点?

在 Agent 的配置文件中设置 `S3_ENDPOINT`、`S3_ACCESS_KEY`、`S3_SECRET_KEY` 和默认 `BUCKET_NAME` 即可。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/aios-file-transfer-x-2/raw/index.md 读取 AIOS File Transfer 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。