# 🍙 七牛云自动上传 - 快速开始

## ✨ 特性

- ✅ **OpenClaw Skill** - 无缝集成，无需修改飞书配置
- ✅ **指定路径上传** - `/upload /config/test.txt`
- ✅ **使用原文件名** - `/upload --original`
- ✅ **聊天命令配置** - `/qiniu-config set key value`
- ✅ **多存储桶支持** - 动态管理多个七牛云存储桶

---

## 🚀 5 分钟快速开始

### 1. 检查配置

七牛云配置已存在：

```bash
cat ~/.openclaw/credentials/qiniu-config.json
```

应该显示你的七牛云配置信息。

### 2. 重启 OpenClaw

让 OpenClaw 加载新的 Skill：

```bash
openclaw gateway restart
```

等待 10 秒让服务重启完成。

### 3. 测试 Skill

在飞书中发送：

```
/qiniu-config list
```

应该回复你的七牛云配置信息。

### 4. 测试上传

在飞书中发送：

```
/upload /test/file.txt
[附上一个文件]
```

应该上传文件并回复下载链接。

---

## 📋 使用指令

### 上传文件

| 指令 | 说明 |
|------|------|
| `/upload` | 使用原文件名上传 |
| `/upload --original` | 同上 |
| `/upload /路径/文件名` | 上传到指定路径 |
| `/upload /路径 存储桶` | 指定路径和存储桶 |

### 配置管理

| 指令 | 说明 |
|------|------|
| `/qiniu-config list` | 查看配置 |
| `/qiniu-config set 键 值` | 修改配置 |
| `/qiniu-config set-bucket 名 JSON` | 添加存储桶 |
| `/qiniu-config reset` | 重置配置 |
| `/qiniu-help` | 查看帮助 |

---

## 📁 文件结构

```
~/.openclaw/workspace/skills/qiniu-uploader/
├── 📄 SKILL.md                   # Skill 说明
├── 📄 package.json               # Skill 配置
├── 🔧 openclaw-processor.js      # ⭐ OpenClaw 处理器
├── 📖 INTEGRATION.md             # 集成文档
├── 📖 README.md                  # 完整文档
├── 📖 CHEATSHEET.md              # 快速参考
└── 📂 scripts/
    ├── upload-to-qiniu.js        # 上传脚本
    └── feishu-listener.js        # 独立监听器（可选）
```

---

## 🔧 配置说明

### 七牛云配置

位置：`~/.openclaw/credentials/qiniu-config.json`

当前配置：
- **AccessKey**: `YO_W...S_pK`
- **SecretKey**: `NlcJ...rMX7`
- **Bucket**: `daoqires`
- **Region**: `z0` (华东)
- **Domain**: `https://daoqi.daoqi888.cn`

### 飞书配置

已使用 OpenClaw 的飞书配置，无需额外设置。

---

## 🎯 使用场景

### 上传配置文件

```
/upload /config/app/config.json
[附上 config.json]
```

### 上传图片

```
/upload /images/2026/photo.jpg
[附上图片]
```

### 修改 CDN 域名

```
/qiniu-config set default.domain https://new-cdn.com
```

### 添加生产环境

```
/qiniu-config set-bucket production '{"accessKey":"...","secretKey":"...","bucket":"prod","region":"z0","domain":"https://prod-cdn.com"}'
```

然后上传到生产环境：

```
/upload /assets/main.js production
[附上 main.js]
```

---

## 🔍 故障排查

### Skill 未响应

```bash
# 检查 OpenClaw 状态
openclaw status

# 重启 OpenClaw
openclaw gateway restart

# 查看日志
openclaw logs --tail 50
```

### 上传失败

```bash
# 检查七牛配置
cat ~/.openclaw/credentials/qiniu-config.json

# 手动测试上传脚本
cd ~/.openclaw/workspace/skills/qiniu-uploader
node scripts/upload-to-qiniu.js config list
```

### 测试处理器

```bash
cd ~/.openclaw/workspace/skills/qiniu-uploader
node openclaw-processor.js --message '{"content":{"text":"/qiniu-config list"}}'
```

应该输出 JSON 格式的回复。

---

## 📖 更多文档

- **快速参考** → `CHEATSHEET.md`
- **完整文档** → `README.md`
- **集成指南** → `INTEGRATION.md`
- **架构说明** → `ARCHITECTURE.md`
- **更新说明** → `UPGRADE.md`

---

## 💡 提示

1. **路径规范**：建议使用 `/` 开头，如 `/config/file.txt`
2. **原文件名**：不指定路径时自动使用原文件名
3. **配置安全**：使用聊天命令修改，避免明文传输
4. **多环境**：使用不同存储桶区分环境（dev/staging/prod）

---

**配置完成！开始使用吧！** 🍙