AIOS File Transfer

为AIOS Agent处理S3兼容文件传输

开发流程 后端开发运维工程师智能体开发 管理文件传输 通用 ★ 855 更新于 2026-08-01

安装使用

复制下面这段提示词发给你的 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 格式),按其中说明在我的环境里完成安装和配置。