功能特性: - 支持 /upload, /u 命令上传文件到七牛云 - 支持 /qiniu-config 配置管理 - 支持飞书卡片交互 - 支持指定上传路径和存储桶 - 自动刷新 CDN 缓存 - 支持文件覆盖上传 包含组件: - OpenClaw 处理器 (openclaw-processor.js) - 独立监听器 (scripts/feishu-listener.js) - 核心上传脚本 (scripts/upload-to-qiniu.js) - 部署脚本 (deploy.sh) - 完整文档 部署方式: 1. 复制 skill 到 ~/.openclaw/workspace/skills/ 2. 配置 ~/.openclaw/credentials/qiniu-config.json 3. 重启 OpenClaw Gateway
90 lines
2.1 KiB
Markdown
90 lines
2.1 KiB
Markdown
# 🍙 七牛云上传 - 快速参考
|
|
|
|
## 📤 上传指令
|
|
|
|
| 指令 | 说明 | 示例 |
|
|
|------|------|------|
|
|
| `/upload` | 使用原文件名上传 | `/upload` + 文件 |
|
|
| `/upload --original` | 同 `/upload` | `/upload --original` + 文件 |
|
|
| `/upload 路径` | 上传到指定路径 | `/upload /config/file.txt` + 文件 |
|
|
| `/upload 路径 存储桶` | 指定路径和存储桶 | `/upload /docs/r.pdf prod` + 文件 |
|
|
|
|
## ⚙️ 配置命令
|
|
|
|
| 命令 | 说明 | 示例 |
|
|
|------|------|------|
|
|
| `/qiniu-config list` | 查看配置 | `/qiniu-config list` |
|
|
| `/qiniu-config set 键 值` | 修改配置 | `/qiniu-config set default.accessKey XXX` |
|
|
| `/qiniu-config set-bucket 名称 JSON` | 添加存储桶 | `/qiniu-config set-bucket prod '{...}'` |
|
|
| `/qiniu-config reset` | 重置配置 | `/qiniu-config reset` |
|
|
| `/qiniu-help` | 查看帮助 | `/qiniu-help` |
|
|
|
|
## 🔑 可配置项
|
|
|
|
```
|
|
default.accessKey - 访问密钥
|
|
default.secretKey - 密钥
|
|
default.bucket - 存储桶名称
|
|
default.region - 区域 (z0/z1/z2/na0/as0)
|
|
default.domain - CDN 域名
|
|
```
|
|
|
|
## 📋 区域代码
|
|
|
|
| 代码 | 区域 |
|
|
|------|------|
|
|
| `z0` | 华东(浙江) |
|
|
| `z1` | 华北(河北) |
|
|
| `z2` | 华南(广东) |
|
|
| `na0` | 北美 |
|
|
| `as0` | 东南亚 |
|
|
|
|
## 🎯 常用场景
|
|
|
|
### 上传配置文件
|
|
```
|
|
/upload /config/app/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
|
|
[文件]
|
|
```
|
|
|
|
## 🔧 命令行
|
|
|
|
```bash
|
|
# 上传
|
|
node scripts/upload-to-qiniu.js upload --file ./f.txt --key /path/f.txt
|
|
|
|
# 配置
|
|
node scripts/upload-to-qiniu.js config list
|
|
node scripts/upload-to-qiniu.js config set default.accessKey XXX
|
|
|
|
# 启动
|
|
./scripts/start-listener.sh
|
|
```
|
|
|
|
## 📞 帮助
|
|
|
|
- 飞书中:`/qiniu-help`
|
|
- 文档:`cat README.md`
|