核心用法
file-upload-skill 是 OpenClaw 生态的本地文件上传组件，通过独立 Web 服务（默认端口 15170）实现浏览器端文件上传，供 AI 分析处理。安装后自动启动服务，用户可通过拖拽或点击完成上传，支持 PDF、图片、日志、代码等多种格式。
关键流程：
1. 安装技能包自动部署上传服务
2. 访问 http://<ip>:15170/?token=<认证值>
3. 拖拽文件上传，AI 自动识别并分析
4. 文件保存至本地 ~/.openclaw/workspace/uploads/
显著优点
- 数据私有性：文件仅存本地，不上传云端，满足敏感数据处理需求
- 智能认证适配：自动兼容 Token/Password/无认证三种模式，无需手动配置
- AI 无缝集成：用户询问"如何上传文件"时，AI 自动返回正确地址（隐藏真实认证值）
- 开箱即用：一键安装，自动配置，支持中文文件名与 50MB 大文件
- 独立服务架构：不影响 Gateway 主服务，故障隔离
潜在缺点与局限
- 网络可达性限制：需确保客户端能访问服务器 15170 端口，Tailscale 场景下需额外配置
- 无加密传输：HTTP 明文传输，建议配合 Tailscale/WireGuard 等私有网络使用
- 单点存储：无分布式备份，依赖本地磁盘可靠性
- 认证降级风险：未配置认证时虽能使用，但会收到安全警告
适合人群
- 注重数据隐私、不愿将文件上传云端的企业用户与个人开发者
- 需要 AI 分析本地敏感文档（合同、日志、内部代码）的技术团队
- 已部署 OpenClaw Gateway 的现有用户，希望扩展文件交互能力
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 未授权访问 | 无认证配置时任何人可上传 | 配置 token/password 认证，配合防火墙 |
| 路径遍历攻击 | 恶意文件名尝试访问上级目录 | 内置文件名 sanitization，目录隔离 |
| 存储耗尽 | 大文件/大量上传占满磁盘 | 监控 uploads 目录，配置磁盘告警 |
| 信息泄露 | 认证值硬编码或日志泄露 | 动态读取配置，日志脱敏处理 |
综合评估
该技能填补了 OpenClaw 生态中"本地安全上传"的空白，设计上优先考虑隐私与易用性平衡。智能认证适配是亮点功能，显著降低配置门槛。建议生产环境必开认证，并配合 Tailscale 等零信任网络使用。