AIOS File Transfer

为AI agent提供S3兼容的文件传输能力

开发流程 智能体开发后端开发全栈开发 管理文件传输 通用 ★ 843 更新于 2026-07-31

安装使用

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

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

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

使用示例

'请帮我处理这个 file_input://my-bucket/report.pdf,下载到工作区后提取其中的表格数据。' 它会自动下载文件,调用后续数据处理技能完成任务。又如:'将工作区中的 result.csv 上传为 file_output://my-bucket/output/result.csv',它会自动上传并返回可访问的链接。

介绍

AI agent在处理复杂任务时,经常需要从外部存储读取输入文件或将结果保存到指定位置。AIOS File Transfer 通过兼容 AWS S3 的 SDK,为 OpenClaw 和 AIOS agent 打通了文件传输通道,让 agent 能够像操作本地文件一样处理远程存储中的文件。当 agent 收到 file_input://... 这类 URI 时,会自动按当前 senderId 将文件下载到工作区;需要上传时,也能将 senderId 目录内的本地文件上传并生成 file_output://... 供下游使用。

使用方式非常简单:安装本 Skill 后,在 agent 的配置中指定 S3 兼容的存储端点(如 MinIO、AWS S3、阿里云 OSS 等),即可自动启用文件传输能力。agent 在对话中收到 file_input:// 链接时会自动下载,无需额外编码;上传场景也只需将文件放入指定目录,agent 会自动处理。整个过程对开发者透明,减少了手动管理文件传输的繁琐工作。

本 Skill 适合以下用户:开发 AI agent 的工程师(尤其是使用 OpenClaw 或 AIOS 框架的团队)、需要将 agent 与云存储集成的后端开发者、以及搭建自动化工作流时希望简化文件 I/O 的运维人员。它屏蔽了底层 S3 调用的复杂性,让 agent 可以专注于业务逻辑。

使用建议:请确保提前配置好 S3 兼容存储的访问密钥和端点地址,并检查网络连通性。由于依赖 SDK 版本,如果遇到兼容性问题,请确认 agent 运行环境中的 Python(或 Node.js)版本与 Skill 要求一致。另外,注意 senderId 的隔离机制,避免多用户场景下文件冲突。

核心特点

与普通的文件传输工具不同,本 Skill 专为 AI agent 的对话式工作流设计,自动识别 `file_input://` / `file_output://` 协议,并利用 `senderId` 实现多用户文件隔离,无需手动编写任何上传下载代码。

注意事项

依赖外部 S3 兼容存储服务,无法用于本地文件系统直接传输,且需要 agent 运行时具备网络访问权限。

常见问题

如何配置 S3 兼容存储的访问密钥?

在 agent 的环境变量中设置 `S3_ENDPOINT`、`S3_ACCESS_KEY`、`S3_SECRET_KEY` 和 `S3_BUCKET`,本 Skill 会自动读取。

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

支持所有兼容 AWS S3 协议的服务,包括 MinIO、阿里云 OSS、腾讯云 COS、华为云 OBS 等。

给 AI 助手的安装指引

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

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