☁️ 七牛云 KODO 技能

通过 MCP 工具 / Node.js SDK / qshell CLI 管理七牛云对象存储。

---

🎯 执行策略（三层降级）

优先级	工具	使用场景
1	qiniu-mcp-server	功能最全，优先使用
2

Node.js SDK | MCP 不可用时降级 |
| 3 | qshell CLI | 最后备选 |

---

🚀 快速开始

1. 安装依赖

bash

进入技能目录

cd ~/.openclaw/workspace/skills/qiniu-kodo

运行自动安装

bash scripts/setup.sh

2. 配置凭证

bash
bash scripts/setup.sh \
--access-key YOURACCESSKEY \
--secret-key YOURSECRETKEY \
--region z0 \
--bucket mybucket

3. 测试连接

bash
node scripts/qiniu_node.mjs test-connection

---

📋 使用示例

上传文件

bash
node scripts/qiniu_node.mjs upload \
--local /path/to/file.txt \
--key uploads/file.txt

列出文件

bash
node scripts/qiniu_node.mjs list --prefix uploads/ --limit 100

下载文件

bash
node scripts/qiniu_node.mjs download \
--key uploads/file.txt \
--local /path/to/save.txt

删除文件

bash
node scripts/qiniu_node.mjs delete --key uploads/file.txt --force

获取文件 URL

bash

公开空间

node scripts/qiniu_node.mjs url --key uploads/file.txt

私有空间（1小时有效）

node scripts/qiniu_node.mjs url --key uploads/file.txt --private --expires 3600

---

🔧 Node.js SDK API

命令	说明
upload --local <path> --key <key>	上传文件
download --key <key> --local <path>

下载文件 | | list [--prefix

] [--limit ] | 列出文件 | | delete --key [--force] | 删除文件 | | url --key [--private] [--expires ] | 获取 URL | | stat --key | 文件信息 | | move --src-key --dest-key | 移动文件 | | copy --src-key --dest-key | 复制文件 | | test-connection | 测试连接 |

---

⚙️ 配置文件

config/qiniu-config.json

json
{
accessKey: YOURACCESSKEY,
secretKey: YOURSECRETKEY,
bucket: mybucket,
region: z0,
domain: https://cdn.example.com
}

区域代码：

• - z0 - 华东（杭州）
• z1 - 华北（河北）
• z2 - 华南（广州）
• na0 - 北美（洛杉矶）
• as0 - 东南亚（新加坡）

---

🐛 故障排查

问题	解决
Cannot find module qiniu	npm install qiniu
401 Unauthorized

检查 AccessKey/SecretKey |
| 连接超时 | 检查区域代码和网络 |

---

📚 相关链接

• - 七牛云 MCP Server
• 七牛云 Node.js SDK
• qshell 工具

---

📄 许可证

MIT License