Agent-to-Owner 文件桥接

从代理的工作区上传文件，并为所有者生成下载或预览链接。该桥接服务器开源、可自托管，所有敏感操作均需用户明确授权。

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

🔒 权限与安全边界

此技能有两种模式。所有操作均需用户明确选择并批准后方可执行：

代理不会在未获授权的情况下自动执行任何操作。每一步都需用户明确确认。

🛠 部署设置

桥接服务器是一个独立的开源 PHP 或 Python 文件，由用户自行部署在自己的基础设施上。

方式 A — PHP（推荐用于共享主机）

1. 将 index.php 放置在任意支持 PHP 的主机上。
2. 在 .env 文件中设置 API_KEY。
3. 记下服务器 URL 和密钥。

方式 B — Python（VPS / 本地机器）

1. 执行 pip install flask，然后运行 python server.py。
2. 在 .env 文件中设置 API_KEY。
3. 记下服务器 URL 和密钥。

配置完成后，将你的 服务器地址 和 API 密钥 提供给代理——无需额外设置。

🤖 代理工作流程

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

1. 检查桥接配置： 当前会话中是否已配置服务器地址和 API 密钥？若是，跳至第 4 步。

1. 引导接入： 向用户提出唯一一个问题：

“我可以帮你分享文件。你希望如何处理托管？

1. 手动模式（推荐）： 你已有服务器——请提供 URL 和 API 密钥，我将立即上传。
2. 自主模式： 我将在我的工作区中临时搭建一个本地桥接，并开启公共隧道。此过程需你在每一步进行授权。”

1. 自主模式（仅当用户明确选择时启用）：

步骤 3a — 启动前获取用户确认：

“为了运行桥接服务器，我将执行：(1) 从开源仓库复制 server.py，(2) 生成 API 密钥并保存至我工作区的 .env 文件，(3) 在端口 5000 启动服务器。是否允许继续？”

- 仅当用户回复“是”时才继续。

步骤 3b — 开启隧道前获取用户确认：

“为了让服务器可被访问，我将开启一个临时公共隧道（通过 localtunnel 或 localhost.run）。这将创建一个指向我本地 5000 端口的公开链接。该链接将在会话结束时失效。是否允许开启隧道？”

- 仅当用户同意时才执行。

- 隧道建立后，向用户提示：*“隧道链接为 [URL]。此链接为临时使用，会话结束后将失效。”*

1. 上传文件：

- 使用 POST 请求发送文件至服务器地址，包含 X-API-Key 请求头和 file 表单字段。

- 返回的 JSON 响应包含 url（直接下载链接）和 view_url（浏览器内嵌预览链接）。

- **向用户提供 view_url**：适用于文本、代码、图片和 ZIP 文件，可在浏览器中即时渲染内容。

- 若为二进制文件或需要原始下载链接，提供 url。

📋 API 接口参考

认证方式：所有接口需在请求头中携带 X-API-Key。

📎 内置参考文档

参见 api_instructions.txt，其中包含简洁的 API 快速参考表，含 curl 示例。