☁️ 七牛云 KODO 技能

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

🎯 执行策略（三层降级）

🚀 快速开始

1. 安装依赖

# 进入技能目录
cd ~/.openclaw/workspace/skills/qiniu-kodo

# 运行自动安装
bash scripts/setup.sh

2. 配置凭证

bash scripts/setup.sh \
  --access-key "YOUR_ACCESS_KEY" \
  --secret-key "YOUR_SECRET_KEY" \
  --region "z0" \
  --bucket "mybucket"

3. 测试连接

node scripts/qiniu_node.mjs test-connection

📋 使用示例

上传文件

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

列出文件

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

下载文件

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

删除文件

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

获取文件 URL

# 公开空间
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

⚙️ 配置文件

config/qiniu-config.json

{
  "accessKey": "YOUR_ACCESS_KEY",
  "secretKey": "YOUR_SECRET_KEY",
  "bucket": "mybucket",
  "region": "z0",
  "domain": "https://cdn.example.com"
}

区域代码：

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

🐛 故障排查

📚 相关链接

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

📄 许可证

MIT License