AIOS File Transfer
为AIOS Agent处理S3兼容文件传输
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:AIOS File Transfer。 它的用途是:为AIOS Agent处理S3兼容文件传输 完整的 Skill 内容见:https://321skill.com/skills/aios-file-transfer-x-7/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'请将当前工作区中的report.pdf通过file_output协议上传到AIOS存储',它会自动按当前senderId创建目录并上传文件,返回如'file_output://reports/2025/04/report.pdf'的URI供后续使用。
介绍
AIOS File Transfer 解决了AI Agent在文件传输场景中的核心痛点:当Agent需要从外部存储接收文件(如 file_input:// URI)或向外部存储上传文件时,如何安全、高效地按用户身份(senderId)隔离文件,并自动完成下载与上传操作。该Skill通过兼容AWS S3的SDK,将文件传输逻辑与Agent工作流无缝集成。
使用方式极为简洁:Agent在收到 file_input:// 开头的URI时,Skill会自动识别当前 senderId,将对应文件下载到工作区;当Agent需要将本地文件上传时,只需指定目标路径,Skill会自动按 senderId 构建目录并上传,返回 file_output:// 格式的URI供后续使用。无需手动管理凭证、路径或并发冲突。
本Skill最适合后端开发、运维工程师和智能体开发者,尤其是那些在OpenClaw或AIOS平台上构建自动化工作流的团队。如果你正在开发需要读写外部对象存储的AI Agent,或需要为多用户Agent系统提供安全隔离的文件传输通道,这个Skill可以大幅降低集成成本。
使用建议:确保已配置兼容AWS S3的存储服务(如MinIO、阿里云OSS、AWS S3等),并在环境中设置正确的访问密钥和区域。对于高并发场景,建议根据业务量调整SDK的请求超时和重试策略。注意:该Skill依赖标准S3协议,不兼容非S3协议的对象存储。
核心特点
与通用文件传输SDK不同,AIOS File Transfer专为AIOS和OpenClaw Agent的 file_input/file_output 协议设计,自动按 senderId 隔离文件目录,无需手动管理路径和权限,开箱即用。
注意事项
仅支持兼容AWS S3协议的对象存储,不适用于FTP、SFTP、本地文件系统等其他传输协议。
常见问题
如何配置AWS S3凭证?
在环境变量中设置AWS_ACCESS_KEY_ID和AWS_SECRET_ACCESS_KEY,或通过SDK的配置文件指定。具体请参考AWS S3官方文档。
支持哪些文件类型?
支持所有文件类型,无限制。但大文件传输可能受超时配置影响,建议调整SDK的请求超时参数。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/aios-file-transfer-x-7/raw/index.md 读取 AIOS File Transfer 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/aios-file-transfer-x-7/raw/index.md(查看排版版本)