aliyun-oss
阿里云 OSS 对象存储技能。支持文件上传、下载、列出、删除、获取 URL 等操作。 两层架构:Node.js SDK(优先)→ ossutil CLI。 Skill: aliyun-oss Owner: langhuachuanshi Summary: 阿里云 OSS 对象存储技能。支持文件上传、下载、列出、删除、获取 URL 等操作。 两层架构:Node.js SDK(优先)→ ossutil CLI。 Tags: aliyun:1.0.2, cloud:1.0.2, latest:1.0.2, oss:1.0.2, storage:1.0.2 Version history: v1.0.2 | 2026-03-06T17:10:56.423Z | auto - No file changes detected in this release. - Documentation (SKILL.md) remains unchanged from the previous version. - No new features, bug fixes, or updates inclu
Rank
62
Safety
84
Downloads
1.3k
Updated
Oct 10, 2026
Version
1.0.2
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.2release · observed Mar 6, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s172yjpf05bfj3wjfrwx88v8sx83hf31:aliyun-oss-skill- 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-aliyun-oss-skill/snapshot"
Documentation
CLAWHUB
37,478 characters of source documentation, loaded on request.
Extracted files
5 files captured from the source.
SKILL.md
---
name: aliyun-oss
description: |
阿里云 OSS 对象存储技能。支持文件上传、下载、列出、删除、获取 URL 等操作。
两层架构:Node.js SDK(优先)→ ossutil CLI。
metadata:
{
"openclaw":
{
"emoji": "☁️",
"requires": { "bins": ["node"], "packages": ["ali-oss"] },
"install":
[
{ "id": "ali-oss-sdk", "kind": "node", "package": "ali-oss", "label": "Install ali-oss Node.js SDK" },
],
},
}
---
# ☁️ 阿里云 OSS 技能
通过 **Node.js SDK** / **ossutil CLI** 管理阿里云对象存储。
---
## 🎯 执行策略(两层降级)
| 优先级 | 工具 | 使用场景 |
|--------|------|----------|
| **1** | Node.js SDK (`ali-oss`) | 优先使用 |
| **2** | ossutil CLI | 备选 |
---
## 🚀 快速开始
### 1. 安装依赖
```bash
# 进入技能目录
cd ~/.openclaw/workspace/skills/aliyun-oss-skill
# 运行自动安装
bash scripts/setup.sh
```
### 2. 配置凭证
```bash
bash scripts/setup.sh \
--access-key-id "YOUR_ACCESS_KEY_ID" \
--access-key-secret "YOUR_ACCESS_KEY_SECRET" \
--region "oss-cn-hangzhou" \
--bucket "mybucket"
```
### 3. 测试连接
```bash
node scripts/oss_node.mjs test-connection
```
---
## 📋 使用示例
### 上传文件
```bash
node scripts/oss_node.mjs upload \
--local "/path/to/file.txt" \
--key "uploads/file.txt"
```
### 列出文件
```bash
node scripts/oss_node.mjs list --prefix "uploads/" --limit 100
```
### 下载文件
```bash
node scripts/oss_node.mjs download \
--key "uploads/file.txt" \
--local "/path/to/save.txt"
```
### 删除文件
```bash
node scripts/oss_node.mjs delete --key "uploads/file.txt" --force
```
### 获取文件 URL
```bash
# 公开空间
node scripts/oss_node.mjs url --key "uploads/file.txt"
# 私有空间(1小时有效)
node scripts/oss_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/oss-config.json**
```json
{
"accessKeyId": "YOUR_ACCESS_KEY_ID",
"accessKeySecret": "YOUR_ACCESS_KEY_SECRET",
"bucket": "mybucket",
"region": "oss-cn-hangzhou",
"domain": "https://cdn.example.com"
}
```
**常用区域**:
- `oss-cn-hangzhou` - 华东1(杭州)
- `oss-cn-shanghai` - 华东2(上海)
- `oss-cn-beijing` - 华北2(北京)
- `oss-cn-shenzhen` - 华南1(深圳)
---
## 🐛 故障排查
| 问题 | 解决 |
|------|------|
| `Cannot find module 'ali-oss'` | `npm install ali-oss` |
| `403 Forbidden` | 检查 AccessKey 权限 |
| `连接超时` | 检查区域代码和网络 |
---
## 📚 相关链接
- [阿里云 OSS Node.js SDK](https://help.aliyun.com/document_detail/32068.html)
- [ossutil 工具](https://help.aliyun.com/document_detail/120075.html)
---
## 📄 许可证
MIT LicenseREADME.md
# ☁️ 阿里云 OSS 技能 OpenClaw 技能,用于管理阿里云对象存储(OSS)。 ## ✨ 功能 - 📤 上传文件 - 📥 下载文件 - 📋 列出文件 - 🗑️ 删除文件 - 🔗 获取文件 URL(支持私有空间签名) - 📊 查看文件信息 - 📁 移动/复制文件 ## 🚀 快速开始 ```bash # 安装依赖 npm install # 配置凭证 bash scripts/setup.sh --access-key-id "xxx" --access-key-secret "xxx" --region "oss-cn-hangzhou" --bucket "mybucket" # 测试连接 node scripts/oss_node.mjs test-connection ``` ## 📖 使用示例 ```bash # 上传 node scripts/oss_node.mjs upload --local file.txt --key uploads/file.txt # 列出 node scripts/oss_node.mjs list --prefix uploads/ # 下载 node scripts/oss_node.mjs download --key uploads/file.txt --local file.txt # 删除 node scripts/oss_node.mjs delete --key uploads/file.txt --force # 获取 URL node scripts/oss_node.mjs url --key uploads/file.txt ``` ## 🔧 架构 两层降级策略: 1. **Node.js SDK** (`ali-oss`) - 优先使用 2. **ossutil CLI** - 备选 ## 📄 许可证 MIT
_meta.json
{
"ownerId": "kn78r3ca13npsxrn5f905res8n821ssm",
"slug": "aliyun-oss-skill",
"version": "1.0.2",
"publishedAt": 1772817056423
}docs/EXAMPLES.md
# 阿里云 OSS 技能 - 使用示例
本文档包含阿里云 OSS 技能的各种使用示例。
---
## 📤 示例1:上传文件
### 在 OpenClaw 中
**用户说:**
```
帮我上传 /backups/daily-20260301.tar.gz 到阿里云 OSS
```
**AI 执行:**
```
使用 Node.js SDK 脚本上传
```
**返回:**
```
✅ 上传成功!
文件:daily-20260301.tar.gz
大小:15.2 MB
URL:https://bucket.oss-cn-hangzhou.aliyuncs.com/backups/daily-20260301.tar.gz
```
### 命令行方式
```bash
node scripts/oss_node.mjs upload \
--local /backups/daily-20260301.tar.gz \
--key backups/daily-20260301.tar.gz
```
---
## 📋 示例2:列出文件
### 在 OpenClaw 中
**用户说:**
```
列出阿里云 OSS 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/oss_node.mjs list
# 列出指定前缀的文件
node scripts/oss_node.mjs list --prefix backups/ --limit 50
# JSON 格式输出
node scripts/oss_node.mjs list --prefix backups/ --format json
```
---
## 🔗 示例3:获取文件 URL
### 在 OpenClaw 中
**用户说:**
```
给我 images/photo.jpg 的访问链接,1小时有效
```
**返回:**
```
🔗 临时访问链接(1小时有效):
https://bucket.oss-cn-hangzhou.aliyuncs.com/images/photo.jpg?OSSAccessKeyId=...&Expires=...&Signature=...
```
### 命令行方式
```bash
# 公开 URL
node scripts/oss_node.mjs url --key images/photo.jpg
# 私有 URL(1小时有效)
node scripts/oss_node.mjs url --key documents/report.pdf --private --expires 3600
```
---
## 🗑️ 示例4:删除文件
### 在 OpenClaw 中
**用户说:**
```
删除阿里云 OSS 上的 old-backup.tar.gz
```
**AI 执行:**
```
1. 先确认:是否真的要删除?
2. 用户确认后执行删除
```
**返回:**
```
✅ 删除成功!
文件:old-backup.tar.gz
```
### 命令行方式
```bash
# 删除单个文件(需要确认)
node scripts/oss_node.mjs delete --key backups/old-backup.tar.gz
# 强制删除(不需要确认)
node scripts/oss_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/oss_node.mjs batch-delete --file delete-list.txt
```
---
## 📊 示例5:获取文件信息
### 在 OpenClaw 中
**用户说:**
```
查看 documents/report.pdf 的详细信息
```
**返回:**
```
📊 文件信息:
文件名:documents/report.pdf
大小:2.5 MB
类型:application/pdf
ETag:"abc123..."
修改时间:2026-03-01 15:30:00
```
### 命令行方式
```bash
node scripts/oss_node.mjs stat --key documents/report.pdf
```
---
## 📥 示例6:下载文件
### 在 OpenClaw 中
**用户说:**
```
从阿里云 OSS 下载 documents/report.pdf 到本地
```
**返回:**
```
✅ 下载成功!
文件:documents/report.pdf
大小:2.5 MB
保存到:/downloads/report.pdf
```
### 命令行方式
```bash
node scripts/oss_node.mjs download \
--key documents/report.pdf \
--local /downloads/report.pdf
```
---
## 🤖 示例7:自动化备份脚本
### 完整脚本
```bash
#!/bin/bash
# 每日备份脚本
BACKUP_DIR="/backups"
DATE=$(date +%Y%m%d)
BACKUP_FILE="backup-${DATE}.tar.gz"
# 1. 创建备份
echo "📦 创建备份..."
tar -czf "${BACKUP_DIR}/${BACKUP_FILE}" /data
# 2. 上传到阿里云 OSS
echo "📤 上传到阿里云 OSS..."
cd /home/node/.openclaw/workspace/skills/aliyun-oss-skill
node scripts/oss_node.mjs upload \
--local "${BACKUP_DIR}/${BACKUP_FILE}" \
--key "backups/${BACKUP_FILE}"
# 3. 清理本地旧备份(保留7天)
echskill-card.md
## Description: aliyun-oss helps agents manage Alibaba Cloud Object Storage (OSS) objects, including upload, download, listing, deletion, metadata inspection, moves, copies, and signed URL generation. 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 operators use this skill to let an agent manage files in Alibaba Cloud OSS buckets through the ali-oss Node.js SDK, with ossutil described as a fallback path. It supports common storage workflows such as backup upload, object discovery, signed URL creation, and object cleanup. ### Deployment Geography for Use: Global ## Known Risks and Mitigations: Risk: The setup flow can persist Alibaba Cloud access keys in shell startup files. Mitigation: Use narrowly scoped RAM or STS credentials, avoid entering secrets in reusable shell history, remove generated exports from shell startup files, and rotate any credentials already exposed this way. Risk: Delete operations may proceed even when the documented interactive confirmation is expected. Mitigation: Review delete commands before execution, avoid relying on the prompt as a safeguard, and require a fixed confirmation implementation before using destructive operations in routine workflows. ## Reference(s): - [ClawHub skill page](https://clawhub.ai/langhuachuanshi/skills/aliyun-oss-skill) - [Aliyun OSS Node.js SDK documentation](https://help.aliyun.com/document_detail/32068.html) - [Aliyun ossutil documentation](https://help.aliyun.com/document_detail/120075.html) ## Skill Output: **Output Type(s):** [guidance, shell commands, configuration, code, text] **Output Format:** [Markdown guidance with shell commands, JSON configuration examples, and command output text] **Output Parameters:** [1D] **Other Properties Related to Output:** [Requires Node.js and the ali-oss package; operates on user-provided Alibaba Cloud OSS credentials and bucket configuration.] ## Skill Version(s): 1.0.2 (source: server release metadata, released 2026-03-06) ## 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.
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!
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
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/langhuachuanshi/skills/aliyun-oss-skill",
"sourceUrl": "https://clawhub.ai/langhuachuanshi/skills/aliyun-oss-skill",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-10T16:46:00.802Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-langhuachuanshi-aliyun-oss-skill/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-langhuachuanshi-aliyun-oss-skill/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-10T16:46:00.802Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "1.3K downloads",
"href": "https://clawhub.ai/langhuachuanshi/aliyun-oss-skill",
"sourceUrl": "https://clawhub.ai/langhuachuanshi/aliyun-oss-skill",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-10T16:46:00.802Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "1.0.2",
"href": "https://clawhub.ai/langhuachuanshi/aliyun-oss-skill",
"sourceUrl": "https://clawhub.ai/langhuachuanshi/aliyun-oss-skill",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-03-06T17:10:56.423Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-langhuachuanshi-aliyun-oss-skill/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-langhuachuanshi-aliyun-oss-skill/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 1.0.2",
"description": "- No file changes detected in this release. - Documentation (SKILL.md) remains unchanged from the previous version. - No new features, bug fixes, or updates included in version 1.0.2.",
"href": "https://clawhub.ai/langhuachuanshi/aliyun-oss-skill",
"sourceUrl": "https://clawhub.ai/langhuachuanshi/aliyun-oss-skill",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-03-06T17:10:56.423Z",
"isPublic": true
}
]
}Record generated Oct 10, 2026.
