AIOS File Transfer

为AIOS智能体提供基于S3的文件上传下载能力

安装使用

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

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

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

使用示例

'请分析这个数据集 file_input://project-a/data.csv 并生成报告保存为 report.pdf',它会自动将 data.csv 从S3下载到当前发送者的工作区,处理完成后,再将生成的 report.pdf 上传回S3,并返回一个 file_output://... 的链接供你下载。

介绍

AIOS File Transfer Skill 解决了AIOS智能体在处理文件输入输出时的核心难题。当智能体接收到 file_input://... 格式的URI时,它无法直接访问,需要一种机制将文件从远程存储下载到本地工作区;同样,当智能体生成了本地文件并需要输出时,也需要将其上传到指定位置并返回一个可访问的 file_output://... URI。本Skill通过集成兼容AWS S3的SDK,为OpenClaw和AIOS agent提供了标准化的文件传输通道。

使用方式非常直接。开发者或用户在配置AIOS环境时,只需安装此Skill并配置好对应的S3兼容存储(如访问密钥、终端节点、存储桶等)。之后,智能体在运行过程中,当遇到文件URI或需要输出文件时,便会自动调用此Skill完成传输,整个过程对用户和智能体逻辑透明。

这个Skill主要适合智能体开发者和运维工程师。对于开发者而言,它省去了在每一个需要处理文件的智能体中重复编写S3客户端代码的麻烦,实现了功能的解耦和复用。对于运维工程师,统一的文件传输通道也便于进行日志审计、流量监控和成本核算。

在使用时,建议确保配置的S3存储服务网络可达且权限设置正确,特别是要注意工作区目录的读写权限以及上传下载过程中的临时文件清理,以避免磁盘空间被占满。对于高频或大文件传输场景,可能需要根据存储服务的性能进行适当的超时和重试参数调优。

核心特点

与需要智能体自行处理文件逻辑的通用方案不同,本Skill深度集成于AIOS框架,能自动识别 `file_input://` 和 `file_output://` 协议并触发传输,实现了文件处理与业务逻辑的彻底分离;同时,它严格按当前 `senderId` 隔离工作目录,确保了多用户场景下的数据安全与隔离。

注意事项

不适合处理非S3协议的文件存储或需要复杂预处理(如实时转码、内容分析)的文件传输场景。

常见问题

这个Skill支持哪些S3兼容的存储服务?

支持所有兼容AWS S3 API的存储服务,如AWS S3本身、MinIO、Cloudflare R2、阿里云OSS等。

如何配置存储桶和访问密钥?

需要通过环境变量或AIOS的配置文件设置S3_ENDPOINT、S3_ACCESS_KEY、S3_SECRET_KEY和S3_BUCKET等参数。

给 AI 助手的安装指引

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

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