技能简介
文件桥接(file-links-tool)允许 AI 代理通过上传文件并生成简单下载 URL,在其私有隔离工作区与用户之间建立桥梁。
能做什么
- 从代理私有工作区上传文件
- 生成直接下载链接
- 支持文本、代码、图片、ZIP预览
- 提供自主模式(代理自建桥接)或手动模式(用户托管)
- ZIP文件支持深度链接
- 批量删除上传的文件
使用说明
安装 Skill:
通过 ClawHub 安装:
clawhub install file-links-tool
前置要求:必须在自有主机(PHP)或通过独立 Python 脚本(IP:PORT)设置桥接服务器。GitHub仓库:https://github.com/mrbeandev/OpenClaw-File-Links-Tool
设置步骤:1. 克隆仓库到主机。2. 按README设置PHP桥接或Python独立桥接(server.py)。3. 在.env中设置API_KEY。4. 向AI代理提供服务器URL和API密钥。
自主模式:克隆server.py,生成安全API_KEY保存到.env,运行服务器(python server.py),使用免费隧道暴露公网(如npx localtunnel –port 5000或ssh -R 80:localhost:5000 localhost.run)。必须告知用户:”我已启动临时免费隧道,此链接将在会话结束或隧道关闭时过期。”
手动模式:等待用户提供SERVER_URL和API_KEY。
执行上传:使用POST /,带X-API-Key头部,文件作为multipart form-data发送。JSON响应包含url(下载)和view_url(查看器)。优先提供view_url预览,二进制或明确要求时提供url。
API端点:POST /(上传)、GET /?action=list(列表)、GET /?action=view&file=…(查看)、POST /?action=delete(批量删除)。
输入与输出
见下方输入与输出表格。
| 项目 | 内容 |
|---|---|
| 输入 | 文件路径、SERVER_URL、API_KEY、桥接模式 |
| 输出 | 下载URL、预览URL、文件列表、删除确认 |
| 适用人群 | 需分享文件的代理、临时传输场景、自动化分享 |
| 不包含 | 永久存储、无需自托管、文件加密 |
风险提示
- 需要自行托管桥接服务器
- 免费隧道有有效期限制
- API密钥需妥善保管
- 文件传输受服务器带宽限制
- 临时链接不适合长期存储
来源信息
原始链接:https://github.com/openclaw/skills/tree/main/skills/mrbeandev/file-links-tool/SKILL.md
来源类型:GitHub
