核心用法
file-upload 是 OpenClaw 生态的文件上传技能，专为本地 AI 工作流设计。用户通过浏览器拖拽上传文件（支持中文名），文件直接保存至本地 workspace 的 uploads/ 目录，供 AI 助手即时分析。服务默认监听 15170 端口，提供 Web 管理界面，支持文件列表查看与删除。
显著优点
- 本地私有：文件不经过任何云端，完全驻留本机，满足敏感数据处理需求
- 智能认证：自动识别 OpenClaw Gateway 的 token/password/无认证三种模式，无缝适配
- AI 原生集成：安装后 AI 自动掌握上传地址，用户问"怎么传文件"即可获得带占位符的安全回复
- 零配置启动：一键安装自动配置，支持自定义端口与路径
- 中文友好：完整支持中文文件名，UI 自带文件类型图标
潜在缺点与局限
- 单点存储：无分布式备份，本机磁盘故障即丢失
- 无公网优化：设计初衷为本地/内网使用，公网暴露需额外防火墙配置
- 容量受限：默认 50MB 单文件限制，大文件需调整配置
- 无版本管理：上传覆盖即替换，无历史版本回溯
- 依赖 Node：运行环境需 Node.js，非纯静态服务
适合人群
- 本地化 AI 部署用户（Ollama/LM Studio + OpenClaw 组合）
- 处理敏感文档的开发者、研究员、法律/医疗从业者
- 需要让 AI 分析日志、代码、截图的技术人员
- 注重数据主权、拒绝云上传的隐私敏感用户
常规风险
- 认证绕过：无认证配置时任意内网 IP 可访问上传接口
- 路径遍历：虽做了文件名 sanitization，自定义代码修改可能引入漏洞
- 端口冲突：15170 被占用时需手动更换端口
- 日志泄露：调试日志可能包含文件元信息，生产环境需清理