Menú
De forma predeterminada está seleccionado el prompt que primero revisa el origen. Puedes cambiar a un comando directo o descargar una copia local.
Lee SKILL.md y los archivos complementarios que muestra SkillsMP antes de decidir si quieres instalarlo.
Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.
Un comando directo omite el prompt de revisión. Revisa el origen antes de ejecutarlo.
npx skills add https://github.com/dvcrn/openclaw-skills-marketplace --skill qiniu-kodoEl comando permanece en una sola línea. Desplázate horizontalmente para revisarlo antes de copiarlo.
¿Prefieres una copia local? Descarga los archivos que SkillsMP tiene disponibles ahora.
Basado en la clasificación ocupacional SOC
Mostrando SKILL.md
| name | qiniu-kodo |
| description | Qiniu KODO Storage Skill |
通过 qiniu-mcp MCP 工具 + Node.js SDK 脚本 + qshell 管理七牛云对象存储和数据处理。
当用户首次要求操作 KODO 时，按以下流程操作：
{baseDir}/scripts/setup.sh --check-only
检查内容：
如果输出显示一切 OK（qiniu-mcp 已安装、凭证已配置），跳到「执行策略」。
告诉用户：
我需要你的七牛云凭证来连接 KODO 存储服务。请提供：
AccessKey — 七牛云 AccessKey
SecretKey — 七牛云 SecretKey
Region — 存储区域（如 z0=华东, z1=华北, z2=华南, na0=北美, as0=东南亚）
Bucket — 存储桶名称
Domain（可选） — 访问域名（用于生成文件 URL，如 http://cdn.example.com）
你可以在七牛云控制台获取：
- 密钥管理：https://portal.qiniu.com/user/key
- 存储桶列表：https://portal.qiniu.com/kodo/bucket
- 区域说明：
- z0: 华东（杭州）
- z1: 华北（河北）
- z2: 华南（广州）
- na0: 北美（洛杉矶）
- as0: 东南亚（新加坡）
{baseDir}/scripts/setup.sh \
--access-key \
--secret-key \
--region \
--bucket \
--domain
脚本会自动：
~/.mcporter/mcporter.json，写入 qiniu-mcp 服务器配置~/.zshrc 或 ~/.bashrc），重启后仍可用{baseDir}/config/qiniu-config.json设置完成后即可开始使用。
三种方式按优先级降级，确保操作始终可完成：
特点： 功能最全，支持存储 + 图片处理 + 音视频处理 + 智能搜索
使用场景：
调用方式：
// 通过 MCP 工具调用
use_mcp_tool("qiniu-mcp", "upload_file", {
localPath: "/path/to/file.txt",
key: "uploads/file.txt"
})
特点： 稳定可靠，支持基础存储操作
使用场景：
调用方式：
node {baseDir}/scripts/qiniu_node.mjs upload \
--local "/path/to/file.txt" \
--key "uploads/file.txt"
node {baseDir}/scripts/qiniu_node.mjs download \
--key "uploads/file.txt" \
--local "/path/to/file.txt"
node {baseDir}/scripts/qiniu_node.mjs list \
--prefix "uploads/" \
--limit 100
特点： 官方命令行工具，功能全面
使用场景：
调用方式：
# 上传文件
qshell fput <Bucket> <Key> <LocalFile>
# 下载文件
qshell get <Bucket> <Key> <LocalFile>
# 列出文件
qshell list <Bucket> <Prefix> <Limit>
# 批量上传
qshell qupload <ThreadCount> <SrcDir> <Bucket>
用户说：
帮我上传 /backups/daily-20260301.tar.gz 到七牛云
AI 执行：
// 优先使用 MCP 工具
result = use_mcp_tool("qiniu-mcp", "upload_file", {
"localPath": "/backups/daily-20260301.tar.gz",
"key": "backups/daily-20260301.tar.gz"
})
// 如果 MCP 不可用，降级到 Node.js SDK
// node scripts/qiniu_node.mjs upload \
// --local "/backups/daily-20260301.tar.gz" \
// --key "backups/daily-20260301.tar.gz"
返回：
✅ 上传成功！
文件：daily-20260301.tar.gz
大小：15.2 MB
URL：http://your-domain.com/backups/daily-20260301.tar.gz
用户说：
列出七牛云 backups 目录下的所有文件
AI 执行：
// 优先使用 MCP 工具
files = use_mcp_tool("qiniu-mcp", "list_files", {
"prefix": "backups/",
"limit": 100
})
// 如果 MCP 不可用，降级到 Node.js SDK
// node scripts/qiniu_node.mjs list --prefix "backups/"
返回：
📋 共找到 15 个文件：
backups/backup-20260301.tar.gz - 15.2 MB - 2026-03-01 20:00
backups/backup-20260228.tar.gz - 14.8 MB - 2026-02-28 20:00
backups/backup-20260227.tar.gz - 16.1 MB - 2026-02-27 20:00
...
用户说：
给我 images/photo.jpg 的访问链接，1小时有效
AI 执行：
// 优先使用 MCP 工具
url = use_mcp_tool("qiniu-mcp", "get_file_url", {
"key": "images/photo.jpg",
"private": true,
"expires": 3600
})
// 如果 MCP 不可用，降级到 Node.js SDK
// node scripts/qiniu_node.mjs url \
// --key "images/photo.jpg" --private --expires 3600
返回：
🔗 临时访问链接（1小时有效）：
http://your-domain.com/images/photo.jpg?e=1583097600&token=...
用户说：
把 images/photo.jpg 缩小到 800x600，加水印
AI 执行：
// 必须使用 MCP 工具（SDK 不支持图片处理）
url = use_mcp_tool("qiniu-mcp", "process_image", {
"key": "images/photo.jpg",
"operations": [
{"type": "resize", "width": 800, "height": 600},
{"type": "watermark", "text": "OpenClaw", "position": "bottom-right"}
]
})
返回：
✅ 图片处理完成！
原图：http://your-domain.com/images/photo.jpg
处理后：http://your-domain.com/images/photo.jpg?imageView2/1/w/800/h/600|watermark/...
用户说：
删除七牛云上 30 天前的备份
AI 执行：
// 使用 Node.js SDK 脚本
const cutoffDate = Date.now() - (30 * 24 * 60 * 60 * 1000);
// 列出所有备份
const { execSync } = require('child_process');
const files = JSON.parse(execSync('node scripts/qiniu_node.mjs list --prefix "backups/" --format json'));
// 删除旧备份
for (const file of files) {
if (file.mtime * 1000 < cutoffDate) {
execSync(`node scripts/qiniu_node.mjs delete --key ${file.key} --force`);
}
}
返回：
🗑️ 已删除 12 个旧备份：
backups/backup-20260115.tar.gz
backups/backup-20260114.tar.gz
...
node scripts/qiniu_node.mjs upload \
--local <LocalPath> \
--key <RemoteKey> \
[--bucket <Bucket>] \
[--overwrite]
node scripts/qiniu_node.mjs download \
--key <RemoteKey> \
--local <LocalPath> \
[--bucket <Bucket>]
node scripts/qiniu_node.mjs list \
[--prefix <Prefix>] \
[--limit <Limit>] \
[--delimiter <Delimiter>] \
[--format json|table]
node scripts/qiniu_node.mjs delete \
--key <RemoteKey> \
[--bucket <Bucket>] \
[--force]
node scripts/qiniu_node.mjs batch-delete \
--file <KeyListFile> \
[--bucket <Bucket>]
node scripts/qiniu_node.mjs url \
--key <RemoteKey> \
[--private] \
[--expires <Seconds>]
node scripts/qiniu_node.mjs stat \
--key <RemoteKey> \
[--bucket <Bucket>]
node scripts/qiniu_node.mjs move \
--src-key <SourceKey> \
--dest-key <DestKey> \
[--bucket <Bucket>] \
[--force]
node scripts/qiniu_node.mjs copy \
--src-key <SourceKey> \
--dest-key <DestKey> \
[--bucket <Bucket>] \
[--force]
use_mcp_tool("qiniu-mcp", "upload_file", {
localPath: string, // 本地文件路径
key: string, // 远程文件名
bucket?: string, // 存储桶（可选）
overwrite?: boolean // 是否覆盖（可选）
})
use_mcp_tool("qiniu-mcp", "download_file", {
key: string, // 远程文件名
localPath: string, // 本地保存路径
bucket?: string // 存储桶（可选）
})
use_mcp_tool("qiniu-mcp", "list_files", {
prefix?: string, // 文件前缀（可选）
limit?: number, // 最大数量（可选）
delimiter?: string // 分隔符（可选）
})
use_mcp_tool("qiniu-mcp", "delete_file", {
key: string, // 远程文件名
bucket?: string // 存储桶（可选）
})
use_mcp_tool("qiniu-mcp", "get_file_url", {
key: string, // 远程文件名
private?: boolean, // 是否私有空间（可选）
expires?: number // 有效期秒数（可选）
})
use_mcp_tool("qiniu-mcp", "process_image", {
key: string, // 图片文件名
operations: [ // 处理操作数组
{
type: "resize", // 缩放
width: 800,
height: 600,
mode: "fit" // fit/fill/crop
},
{
type: "watermark", // 水印
text: "OpenClaw",
position: "bottom-right",
opacity: 0.5
}
]
})
{
"accessKey": "你的AccessKey",
"secretKey": "你的SecretKey",
"bucket": "你的存储桶名称",
"region": "z0",
"domain": "http://你的域名.com",
"options": {
"use_https": true,
"use_cdn": true,
"timeout": 30,
"upload_threshold": 4194304,
"chunk_size": 4194304,
"retry_times": 3
}
}
| 配置项 | 类型 | 必填 | 说明 |
|---|---|---|---|
| accessKey | string | ✅ | 七牛云 AccessKey |
| secretKey | string | ✅ | 七牛云 SecretKey |
| bucket | string | ✅ | 存储桶名称 |
| region | string | ✅ | 区域代码 |
| domain | string | ❌ | 访问域名 |
| use_https | boolean | ❌ | 使用 HTTPS |
| use_cdn | boolean | ❌ | 使用 CDN |
| timeout | number | ❌ | 超时时间（秒） |
| upload_threshold | number | ❌ | 分片上传阈值（字节） |
| chunk_size | number | ❌ | 分片大小（字节） |
| retry_times | number | ❌ | 重试次数 |
症状：
❌ qiniu-mcp 未安装
解决：
# 自动安装
bash scripts/setup.sh --install-mcp
# 或手动安装
npm install -g @qiniu/qiniu-mcp-server
症状：
❌ 凭证验证失败：401 Unauthorized
检查：
解决：
# 重新配置
bash scripts/setup.sh \
--access-key "新的AccessKey" \
--secret-key "新的SecretKey" \
--region "z0" \
--bucket "mybucket"
症状：
❌ 上传失败：连接超时
检查：
解决：
# 检查配置
node scripts/qiniu_node.mjs check-config
# 测试连接
node scripts/qiniu_node.mjs test-connection
症状：
❌ Cannot find module 'qiniu'
解决：
# 安装 SDK
cd /home/node/.openclaw/workspace/skills/qiniu-kodo
npm install qiniu
# 或使用自动安装
bash scripts/setup.sh --install-sdk
症状：
❌ qshell: command not found
解决：
# 下载并安装
wget https://devtools.qiniu.com/qshell-linux-x64-v2.6.2.zip
unzip qshell-linux-x64-v2.6.2.zip
chmod +x qshell
sudo mv qshell /usr/local/bin/
# 配置账号
qshell account <AccessKey> <SecretKey> <Name>
如有问题，请在 OpenClaw 中联系 33。
MIT License