AIOS File Transfer

为AIOS Agent提供S3协议文件传输

效率工具 处理agent文件输入输出传输管理文件传输 通用 ★ 843 更新于 2026-08-02

安装使用

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

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

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

使用示例

'下载 file_input://bucket/path/file.bin 到工作区',它会自动解析URI,调用内置脚本 transfer_s3.mjs,传入当前senderId,将文件下载到 <senderId>/upload 目录,并返回下载结果。如果需要上传文件,可以说:'把 generated/output.txt 发送给用户',它会自动复制到 <senderId>/generated 目录,上传到发件箱bucket,并返回 file_output:// URI。

介绍

这个Skill解决了在AIOS和OpenClaw环境中,AI agent需要安全、规范地传输文件的问题。在实际开发中,AI agent常需要接收用户上传的文件(如file_input:// URI)或向用户发送文件(如file_output:// URI),但直接使用外部工具(如aws CLI)容易导致权限混乱、目录隔离失效等问题。

使用方式很简单,你只需要在AI agent触发文件传输时,自动调用内置的scripts/transfer_s3.mjs脚本,并传入当前通道的--sender-id参数。脚本会使用兼容AWS S3的SDK,将文件下载到<senderId>/upload目录,或从<senderId>/generated目录上传到发件箱bucket。之后就可以通过自然语言指令来管理文件传输流程。

它非常适合需要为AI agent构建文件处理能力的团队或个人。尤其是那些已经部署了OpenClaw或AIOS平台,并希望按照统一规范(如目录隔离、S3协议)管理文件传输的场景。

建议在AI agent的每次文件输入输出操作前,都优先触发此Skill。需要注意的是,它主要依赖AIOS环境变量(如AIOS_S3_ENDPOINT等)和本地Node.js依赖,且必须确保senderId正确,不得使用topic_id代替。

常见问题

如何配置S3连接?

通过AIOS环境变量(AIOS_S3_ENDPOINT、AIOS_S3_REGION、AIOS_S3_ACCESS_KEY_ID、AIOS_S3_SECRET_ACCESS_KEY等)构建S3客户端,无需手动配置。

是否支持直接使用aws CLI?

不允许,必须使用内置的SDK脚本(transfer_s3.mjs),不允许调用aws、s3cmd、mc等外部客户端程序。

给 AI 助手的安装指引

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

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