What makes qiniu-kodo notable?

1.3K downloads. Trust evidence available

How should qiniu-kodo be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this agent.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

agentCLAWHUBUnverified

qiniu-kodo

七牛云 KODO 对象存储技能。支持文件上传、下载、列出、删除、获取 URL 等操作。三层架构：MCP 工具（优先）→ Node.js SDK → qshell CLI。 Skill: qiniu-kodo Owner: langhuachuanshi Summary: 七牛云 KODO 对象存储技能。支持文件上传、下载、列出、删除、获取 URL 等操作。三层架构：MCP 工具（优先）→ Node.js SDK → qshell CLI。 Tags: cloud:1.0.3, kodo:1.0.3, latest:1.0.3, oss:1.0.3, qiniu:1.0.3, storage:1.0.3 Version history: v1.0.3 | 2026-03-06T17:10:15.394Z | auto Version 1.0.3 of qiniu-kodo - No file changes detected in this release. - Documentation, features, and dependencies remain unchanged. v1.0.2 |

OpenClaw

View on ClawHub Homepage

Rank

Safety

Downloads

1.3k

Updated

Oct 10, 2026

Version

1.0.3

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 1.3K downloads reported by the source. Last updated 10/10/2026.

Avoid when

Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor: Clawhubvendor · observed Oct 10, 2026
Protocol compatibility: OpenClawcompatibility · observed Oct 10, 2026
Adoption signal: 1.3K downloadsadoption · observed Oct 10, 2026
Latest release: 1.0.3release · observed Mar 6, 2026
Handshake status: UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s172yjpf05bfj3wjfrwx88v8sx83hf31:qiniu-kodo

Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-langhuachuanshi-qiniu-kodo/snapshot"

Documentation

CLAWHUB

52,669 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: qiniu-kodo
description: |
  七牛云 KODO 对象存储技能。支持文件上传、下载、列出、删除、获取 URL 等操作。
  三层架构：MCP 工具（优先）→ Node.js SDK → qshell CLI。
metadata:
  {
    "openclaw":
      {
        "emoji": "☁️",
        "requires": { "bins": ["node", "python3", "pip3"], "packages": ["qiniu", "qiniu-mcp-server"] },
        "install":
          [
            { "id": "qiniu-sdk", "kind": "node", "package": "qiniu", "label": "Install qiniu Node.js SDK" },
            { "id": "qiniu-mcp", "kind": "python", "package": "qiniu-mcp-server", "label": "Install qiniu-mcp-server" },
          ],
      },
  }
---

# ☁️ 七牛云 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 "YOUR_ACCESS_KEY" \
  --secret-key "YOUR_SECRET_KEY" \
  --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 <p>] [--limit <n>]` | 列出文件 |
| `delete --key <key> [--force]` | 删除文件 |
| `url --key <key> [--private] [--expires <s>]` | 获取 URL |
| `stat --key <key>` | 文件信息 |
| `move --src-key <a> --dest-key <b>` | 移动文件 |
| `copy --src-key <a> --dest-key <b>` | 复制文件 |
| `test-connection` | 测试连接 |

---

## ⚙️ 配置文件

**config/qiniu-config.json**

```json
{
  "accessKey": "YOUR_ACCESS_KEY",
  "secretKey": "YOUR_SECRET_KEY",
  "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](https://github.com/qiniu/qiniu-mcp-server)
- [七牛云 Node.js SDK](https://developer.qiniu.com/kodo/sdk/1289/nodejs)
- [qshell 工具](https://developer.qiniu.com/kodo/tools/1302/qshell)

---

## 📄 许可证

MIT Lic

README.md

# ☁️ 七牛云 KODO 技能

OpenClaw 技能，用于管理七牛云对象存储（KODO）。

## ✨ 功能

- 📤 上传文件
- 📥 下载文件
- 📋 列出文件
- 🗑️ 删除文件
- 🔗 获取文件 URL（支持私有空间签名）
- 📊 查看文件信息
- 📁 移动/复制文件

## 🚀 快速开始

```bash
# 安装依赖
npm install

# 配置凭证
bash scripts/setup.sh --access-key "xxx" --secret-key "xxx" --region "z0" --bucket "mybucket"

# 测试连接
node scripts/qiniu_node.mjs test-connection
```

## 📖 使用示例

```bash
# 上传
node scripts/qiniu_node.mjs upload --local file.txt --key uploads/file.txt

# 列出
node scripts/qiniu_node.mjs list --prefix uploads/

# 下载
node scripts/qiniu_node.mjs download --key uploads/file.txt --local file.txt

# 删除
node scripts/qiniu_node.mjs delete --key uploads/file.txt --force

# 获取 URL
node scripts/qiniu_node.mjs url --key uploads/file.txt
```

## 🔧 架构

三层降级策略：
1. **MCP 工具** (`qiniu-mcp-server`) - 功能最全
2. **Node.js SDK** (`qiniu`) - 稳定可靠
3. **qshell CLI** - 官方命令行

## 📄 许可证

MIT

_meta.json

{
  "ownerId": "kn78r3ca13npsxrn5f905res8n821ssm",
  "slug": "qiniu-kodo",
  "version": "1.0.3",
  "publishedAt": 1772817015394
}

docs/EXAMPLES.md

# 七牛云 KODO 技能 - 使用示例

本文档包含七牛云 KODO 技能的各种使用示例。

---

## 📤 示例1：上传文件

### 在 OpenClaw 中

**用户说：**
```
帮我上传 /backups/daily-20260301.tar.gz 到七牛云
```

**AI 执行：**
```
优先级 1：尝试使用 qiniu-mcp MCP 工具
优先级 2：如果 MCP 不可用，使用 Python SDK
优先级 3：如果 SDK 也不可用，使用 qshell
```

**返回：**
```
✅ 上传成功！

文件：daily-20260301.tar.gz
大小：15.2 MB
URL：http://your-domain.com/backups/daily-20260301.tar.gz
```

### 命令行方式

```bash
node scripts/qiniu_node.mjs upload \
  --local /backups/daily-20260301.tar.gz \
  --key backups/daily-20260301.tar.gz
```

---

## 📋 示例2：列出文件

### 在 OpenClaw 中

**用户说：**
```
列出七牛云 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
...
```

### 命令行方式

```bash
# 列出所有文件
node scripts/qiniu_node.mjs list

# 列出指定前缀的文件
node scripts/qiniu_node.mjs list --prefix backups/ --limit 50

# JSON 格式输出
node scripts/qiniu_node.mjs list --prefix backups/ --format json
```

---

## 🔗 示例3：获取文件 URL

### 在 OpenClaw 中

**用户说：**
```
给我 images/photo.jpg 的访问链接，1小时有效
```

**返回：**
```
🔗 临时访问链接（1小时有效）：

http://your-domain.com/images/photo.jpg?e=1583097600&token=...
```

### 命令行方式

```bash
# 公开空间 URL
node scripts/qiniu_node.mjs url --key images/photo.jpg

# 私有空间 URL（1小时有效）
node scripts/qiniu_node.mjs url --key documents/report.pdf --private --expires 3600
```

---

## 🗑️ 示例4：删除文件

### 在 OpenClaw 中

**用户说：**
```
删除七牛云上的 old-backup.tar.gz
```

**AI 执行：**
```
1. 先确认：是否真的要删除？
2. 用户确认后执行删除
```

**返回：**
```
✅ 删除成功！

文件：old-backup.tar.gz
```

### 命令行方式

```bash
# 删除单个文件（需要确认）
node scripts/qiniu_node.mjs delete --key backups/old-backup.tar.gz

# 强制删除（不需要确认）
node scripts/qiniu_node.mjs delete --key backups/old-backup.tar.gz --force

# 批量删除
cat > delete-list.txt << EOF
backups/backup-20260101.tar.gz
backups/backup-20260102.tar.gz
EOF

node scripts/qiniu_node.mjs batch-delete --file delete-list.txt
```

---

## 📊 示例5：获取文件信息

### 在 OpenClaw 中

**用户说：**
```
查看 documents/report.pdf 的详细信息
```

**返回：**
```
📊 文件信息：

文件名：documents/report.pdf
大小：2.5 MB
类型：application/pdf
Hash：FhGxK...（文件哈希值）
修改时间：2026-03-01 15:30:00
```

### 命令行方式

```bash
node scripts/qiniu_node.mjs stat --key documents/report.pdf
```

---

## 📥 示例6：下载文件

### 在 OpenClaw 中

**用户说：**
```
从七牛云下载 documents/report.pdf 到本地
```

**返回：**
```
✅ 下载成功！

文件：documents/report.pdf
大小：2.5 MB
保存到：/downloads/report.pdf
```

### 命令行方式

```bash
node scripts/qiniu_node.mjs download \
  --key documents/report.pdf \
  --local /downloads/report.pdf
```

---

## 🔄 示例7：移动和复制文件

### 在 OpenClaw 中

**用户说：**
```
把 temp/file.txt 移动到 archive/file.txt
```

**返回：**
```
✅ 文件已移动

原路径：temp/file.txt
新路径：archive/file.txt
```

### 命令行方式（需要扩展）

```bash
# 移动文件（需要扩展 Python 脚本）
# 复制文件（需要扩展 Python 脚本）
```

---

## 🖼️ 示例8：图片处理（需要 MCP）

### 在 OpenClaw 中

**用户说：**
```
把 images/photo.jpg 缩小到 800x600，加水印
```

**AI 执行：**
```
使用 qiniu-mcp MCP 工具进行图片处理
（需要 MCP 工具支持）
```

**返回：**
```
✅ 图片处理完成！

原图：http://yo

skill-card.md

## Description:

Qiniu Kodo helps agents manage Qiniu Cloud Kodo object storage by uploading, downloading, listing, deleting, inspecting, moving, copying objects, and generating file URLs through MCP, the Node.js SDK, or qshell.

This skill is ready for commercial/non-commercial use.

## Publisher:

[langhuachuanshi](https://clawhub.ai/user/langhuachuanshi)

### License/Terms of Use:

MIT

## Use Case:

Developers and engineers use this skill to automate Qiniu Cloud Kodo object-storage workflows from an agent, including object upload, download, listing, deletion, metadata inspection, moves, copies, and URL generation.

### Deployment Geography for Use:

Global

## Known Risks and Mitigations:

Risk: Credential exposure from persisted Qiniu keys or shared-shell usage.

Mitigation: Use narrowly scoped Qiniu credentials, avoid long-lived secrets in shared shells, and inspect shell startup files and mcporter configuration before and after setup.

Risk: Cloud data loss from delete or batch-delete operations.

Mitigation: Avoid destructive operations on production buckets unless independent backups exist and the exact bucket, prefix, and object keys have been verified.

Risk: Installation behavior may modify the user environment through global installs, downloads, and shell-profile edits.

Mitigation: Review the setup script before installing, prefer local package installation, and back up shell startup files before allowing setup changes.

## Reference(s):

- [Qiniu Kodo ClawHub skill page](https://clawhub.ai/langhuachuanshi/skills/qiniu-kodo)
- [Qiniu MCP Server](https://github.com/qiniu/qiniu-mcp-server)
- [Qiniu Node.js SDK documentation](https://developer.qiniu.com/kodo/sdk/1289/nodejs)
- [Qiniu qshell tool documentation](https://developer.qiniu.com/kodo/tools/1302/qshell)
- [Usage examples](docs/EXAMPLES.md)

## Skill Output:

**Output Type(s):** [text, markdown, shell commands, configuration, guidance]

**Output Format:** [Markdown guidance with inline shell commands and JSON configuration examples]

**Output Parameters:** [1D]

**Other Properties Related to Output:** [May propose or run Qiniu object-storage actions that depend on configured credentials, bucket, region, domain, and installed Node.js or MCP tooling.]

## Skill Version(s):

1.0.3 (source: ClawHub release metadata)

## Ethical Considerations:

Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.

Github ReposUpdated 1d agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW

Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW

Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.