名称： "Agent-to-Owner File Bridge"
描述： "从您的私有 AI 工作空间安全上传文件，并为所有者提供直接下载链接。"
标签：
- 文件上传
- 实用工具
- 自动化
- 桥接

Agent-to-Owner 文件桥接工具

此技能允许 AI 代理在其私有的、隔离的工作空间与用户（所有者）之间架起桥梁，通过上传文件并生成简单的下载链接来实现文件共享。

🛠 前置条件与设置

如果您是首次使用此工具，必须在您自己的托管环境（PHP）或通过独立的 Python 脚本（IP:端口）上设置一个桥接服务器。

GitHub 仓库： https://github.com/mrbeandev/OpenClaw-File-Links-Tool

设置步骤：
1. 将仓库克隆到您的主机。
2. 按照 README.md 中的说明，设置 PHP 桥接或独立的 Python 桥接 (server.py)。
3. 在服务器的 .env 文件中设置您的 API_KEY。
4. 向 AI 代理提供您的服务器 URL 和 API 密钥。

🤖 AI 代理操作指南

当用户请求上传或分享文件时：

1. 检查桥接： 确定是否已配置文件桥接。

2. 引导设置（“智能选择”）： 如果桥接不存在，向用户提出一个明确的问题：
   > “我可以帮您分享文件。您希望如何处理文件托管？
   > 1. 自主模式： 我将在自己的工作空间中运行桥接服务器，并直接给您链接。
   > 2. 手动模式： 您自行托管（PHP 或 Python），并向我提供您的服务器 URL 和 API 密钥。”

3. 执行 - 自主模式：

   • 从此仓库克隆/复制 server.py。
   • 生成一个安全的 API_KEY 并保存在 .env 文件中。
   • 运行服务器（例如：python server.py）。
   • 公开暴露（免费隧道）： 使用无需身份验证的免费隧道服务，如 localtunnel (npx localtunnel --port 5000) 或 localhost.run (ssh -R 80:localhost:5000 localhost.run)。
   • 免责声明： 您必须告知用户：“我已启动一个临时的免费隧道。此链接将在我的会话结束或隧道关闭后失效。”
   • 存储生成的 URL 和密钥以备将来使用。

4. 执行 - 手动模式：

   • 等待用户提供 SERVER_URL 和 API_KEY。

5. 执行上传：

   • 向服务器 URL 发送 POST / 请求，并设置 X-API-Key 请求头。
   • 以 multipart 表单数据形式发送文件。
   • 交付链接： JSON 响应包含 url（下载链接）和 view_url（查看器链接）。
     • 首选方案： 对于文本、代码、图片和 ZIP 文件，提供 view_url，以便用户能即时预览。
     • 备选方案： 对于二进制文件类型，或用户明确要求原始下载时，提供 url。

📋 API 接口参考