f6dfa2c8f2
README.md: - 更新部署方式说明（OpenClaw 集成 vs 独立监听器） - 更新文件结构 - 完善故障排查章节 INSTALL.md: - 更新文件结构（删除已清理文件） - 添加 v2.0.0 更新日志 - 标注代码行数 SKILL.md: - 说明卡片交互为可选模式 - 推荐 OpenClaw 集成使用命令触发
188 lines
4.0 KiB
Markdown
188 lines
4.0 KiB
Markdown
# 七牛云上传 Skill - 安装指南
|
||
|
||
## 📦 快速安装
|
||
|
||
### 1. 复制 Skill 目录
|
||
|
||
```bash
|
||
# 从源服务器复制
|
||
scp -r user@source-server:~/.openclaw/workspace/skills/qiniu-uploader \
|
||
~/.openclaw/workspace/skills/
|
||
```
|
||
|
||
### 2. 配置七牛云凭证
|
||
|
||
```bash
|
||
mkdir -p ~/.openclaw/credentials/
|
||
|
||
cat > ~/.openclaw/credentials/qiniu-config.json << 'EOF'
|
||
{
|
||
"buckets": {
|
||
"default": {
|
||
"accessKey": "YOUR_ACCESS_KEY_HERE",
|
||
"secretKey": "YOUR_SECRET_KEY_HERE",
|
||
"bucket": "your-bucket-name",
|
||
"region": "z2",
|
||
"domain": "https://your-cdn-domain.com"
|
||
}
|
||
}
|
||
}
|
||
EOF
|
||
```
|
||
|
||
### 3. 获取七牛云密钥
|
||
|
||
访问七牛云控制台获取密钥：
|
||
- 网址：https://portal.qiniu.com/user/key
|
||
- 创建存储桶：https://portal.qiniu.com/kodo/bucket
|
||
|
||
### 4. 重启 OpenClaw Gateway
|
||
|
||
```bash
|
||
openclaw gateway restart
|
||
```
|
||
|
||
### 5. 验证安装
|
||
|
||
在飞书或其他聊天平台发送：
|
||
|
||
```
|
||
/qiniu-config list
|
||
```
|
||
|
||
应该显示配置信息。
|
||
|
||
---
|
||
|
||
## 📋 文件结构
|
||
|
||
```
|
||
qiniu-uploader/
|
||
├── scripts/
|
||
│ ├── upload-to-qiniu.js # 核心上传脚本
|
||
│ ├── feishu-listener.js # 飞书独立监听器
|
||
│ └── update-bucket-setting.js # 存储桶设置工具
|
||
├── openclaw-processor.js # OpenClaw 处理器
|
||
├── openclaw-handler.js # HTTP 处理器
|
||
├── deploy.sh # 部署脚本
|
||
├── SKILL.md # Skill 说明文档
|
||
├── INSTALL.md # 本文件
|
||
├── README.md # 完整文档
|
||
└── qiniu-config.example.json # 配置示例
|
||
```
|
||
|
||
---
|
||
|
||
## 🔧 配置说明
|
||
|
||
### qiniu-config.json
|
||
|
||
| 字段 | 说明 | 示例 |
|
||
|------|------|------|
|
||
| `accessKey` | 七牛云访问密钥 | `YO_Wi-aMubLmZJr_X5EFOI3WC2a9rfif1fBsS_pK` |
|
||
| `secretKey` | 七牛云密钥 | `NlcJ...rMX7` |
|
||
| `bucket` | 存储桶名称 | `daoqires` |
|
||
| `region` | 区域代码 | `z0`=华东，`z1`=华北，`z2`=华南 |
|
||
| `domain` | CDN 域名 | `https://daoqi.daoqi888.cn` |
|
||
|
||
### 区域代码
|
||
|
||
| 代码 | 区域 |
|
||
|------|------|
|
||
| `z0` | 华东（浙江） |
|
||
| `z1` | 华北（河北） |
|
||
| `z2` | 华南（广东） |
|
||
| `na0` | 北美 |
|
||
| `as0` | 东南亚 |
|
||
|
||
---
|
||
|
||
## 📤 使用方式
|
||
|
||
### 飞书/聊天平台
|
||
|
||
```
|
||
/upload /path/to/file.txt
|
||
/u /path/to/file.txt # 快捷命令
|
||
/upload --original # 使用原文件名
|
||
/qiniu-config list # 查看配置
|
||
```
|
||
|
||
### 命令行
|
||
|
||
```bash
|
||
cd ~/.openclaw/workspace/skills/qiniu-uploader/
|
||
|
||
# 上传文件
|
||
node scripts/upload-to-qiniu.js upload \
|
||
--file ./test.txt \
|
||
--key /test/test.txt \
|
||
--bucket default
|
||
|
||
# 查看配置
|
||
node scripts/upload-to-qiniu.js config list
|
||
|
||
# 修改配置
|
||
node scripts/upload-to-qiniu.js config set default.accessKey YOUR_KEY
|
||
```
|
||
|
||
---
|
||
|
||
## ✅ 功能特性
|
||
|
||
- ✅ 支持覆盖上传同名文件
|
||
- ✅ 支持指定上传路径
|
||
- ✅ 支持多存储桶配置
|
||
- ✅ 自动刷新 CDN 缓存
|
||
- ✅ 显示实际存储桶名称
|
||
- ✅ 临时文件自动清理
|
||
- ✅ 支持 `/upload` 和 `/u` 命令
|
||
|
||
---
|
||
|
||
## 🐛 故障排查
|
||
|
||
### 上传失败
|
||
|
||
1. 检查凭证配置：`/qiniu-config list`
|
||
2. 检查 AccessKey/SecretKey 是否正确
|
||
3. 检查存储桶名称和区域是否匹配
|
||
|
||
### 无法覆盖上传
|
||
|
||
确保上传凭证的 scope 参数包含 key（已修复）
|
||
|
||
### Emoji 显示问题
|
||
|
||
某些 emoji 在某些平台可能不显示，可以修改代码中的 emoji
|
||
|
||
---
|
||
|
||
## 📞 需要帮助？
|
||
|
||
查看完整文档：`README.md`
|
||
|
||
快速参考：`CHEATSHEET.md`
|
||
|
||
---
|
||
|
||
## 📝 版本信息
|
||
|
||
- **Skill 版本**: 2.0.0 (清理版)
|
||
- **兼容 OpenClaw**: 2026.3.2+
|
||
- **七牛云 API**: 表单上传 v2
|
||
- **代码行数**: ~1850 行（核心代码）
|
||
|
||
## 🔄 更新日志
|
||
|
||
### v2.0.0 (2026-03-07)
|
||
- 🧹 清理调试代码和废弃文件（删除 2670 行）
|
||
- ✅ 修复上传成功回复显示实际存储桶名称
|
||
- 🔧 添加 DEBUG 环境变量控制日志输出
|
||
- 📦 优化文件结构，便于部署
|
||
|
||
### v1.1.0
|
||
- ✅ 支持覆盖上传同名文件
|
||
- ✅ 显示实际存储桶名称
|
||
- ✅ 自动刷新 CDN 缓存
|