File Transfer Thru Local Workspace

# file-transfer-thru-local-workspace

OpenClaw 文件传输技能 - 通过网页上传/下载文件到**本地 workspace**，支持技能包浏览下载

## 🎯 与其他上传技能的区别

**❌ 我们不是：**
- ❌ 云存储服务（不是上传到云端）
- ❌ 图床服务（不是获取外链）
- ❌ 文件分享工具（不是分享给他人）

**✅ 我们是：**
- ✅ **本地传输** - 文件保存在你的机器上
- ✅ **AI 分析** - 上传后让 AI 帮你分析文件内容
- ✅ **私有安全** - 文件不离开你的服务器
- ✅ **OpenClaw 集成** - 与你的 AI 助手无缝协作
- ✅ **技能包管理** - 浏览、下载已安装的技能包

**典型使用场景：**
```
1. 上传 PDF → AI 总结内容
2. 上传截屏 → AI 提取文字
3. 上传日志 → AI 分析问题
4. 上传代码 → AI 审查优化
5. 下载技能包 → 备份/分享技能
```

---

## 功能

- 📁 网页端文件上传/下载（支持拖拽）
- 🔐 **智能认证**：自动适配 Token/Password/无认证
- 🇨🇳 支持中文文件名
- 🚀 一键安装，自动配置
- 📦 独立服务，不影响 Gateway
- 🤖 AI 自动回答上传地址
- 📂 文件列表展示与管理
- 🗑️ 支持文件删除
- 🎁 **技能包浏览与下载**

## 快速开始

### 安装

```bash
# 方式 1: 从 ClawHub 安装（推荐）
openclaw skills install file-transfer-thru-local-workspace

# 方式 2: 本地安装
git clone <repo-url> ~/.openclaw/workspace/skills/file-transfer-thru-local-workspace
cd ~/.openclaw/workspace/skills/file-transfer-thru-local-workspace
./install.sh
```

### 使用

安装后自动启动上传服务，访问：

```
http://<server-ip>:15170/?token=<your-auth-value>
```

**🔐 认证说明：**
- 如果你的 Gateway 配置了 **token** → 使用 token
- 如果你的 Gateway 配置了 **password** → 使用 password
- 如果 **无认证** → 直接访问（建议配置认证）

**💡 如何获取认证值：**
```bash
# 查看你的认证配置
cat ~/.openclaw/openclaw.json | grep -A3 '"auth"'
```

### 询问 AI

用户可以直接问：
- "怎么上传文件给你？"
- "上传地址是什么？"
- "如何发送文件？"

AI 会自动回复正确的上传地址（隐藏敏感信息）

## 配置

### 环境变量

```bash
# 可选配置，默认值如下
export UPLOAD_PORT=15170           # 上传服务端口（可自定义）
export UPLOAD_PATH="/upload"       # 上传页面路径
export WORKSPACE="~/.openclaw/workspace"  # 文件保存目录
```...