360 Secure SkillHub
360 安全技能中心

七牛云对象存储

该 Skill 通过脚本将本地文件上传至七牛对象存储，按扩展名自动生成对象 key，并根据空间是否私有返回公网链接或带时效的签名链接，也可为已有对象 key 生成签名链接。需通过环境变量提供七牛 Access Key、Secret Key、Bucket 与公网域名；只负责上传与交付链接，不生成内容。

showtimewalker
showtimewalker
热度 36.60
最近更新 2026-05-11 17:40:07
分类：自动化依赖：代码执行 / 读写文件 / 第三方 API应用场景：工作流 / 自动化脚本

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add qiniu-object-storage
Metadata
name
qiniu_object_storage
description
上传本地文件到七牛对象存储，返回可交付的下载链接。当用户提到"上传""七牛""对象存储""OSS""交付链接""公网链接""签名链接"时引用；当已有本地文件需要上传并获得可访问的 URL 时引用；当工作流完成内容生成后进入交付阶段时引用。自动按扩展名判定文件类型，私有空间返回签名链接，公开空间返回公网链接。
metadata
{"openclaw":{"requires":{"bins":["uv"],"anyBins":["python","python3","py"],"env":["QINIU_ACCESS_KEY","QINIU_SECRET_KEY","QINIU_BUCKET","QINIU_PUBLIC_DOMAIN","QINIU_IS_PRIVATE"]},"primaryEnv":"QINIU_ACCESS_KEY"}}

七牛对象存储

这个 skill 只负责文件上传与交付链接，不负责图片或视频生成。

适用场景：

  • 已有本地文件，需要上传到七牛
  • 需要返回一个可直接交付的下载链接
  • 私有空间需要带时效签名链接

默认行为

  • 对象 key 自动生成为 日期/类型/文件名，如 20260327/images/photo.png
  • 类型按扩展名自动判定：images / videos / audio / others
  • 如果配置里声明空间是私有的，上传后默认返回签名链接
  • 如果配置里声明空间是公开的，上传后默认返回公网链接
  • 只有用户明确要求，或脚本显式传 --private-url / --public-url 时，才覆盖默认行为

使用脚本

脚本位于 skill 目录内的 scripts/，运行时始终使用绝对路径。

设 QINIU_SKILL_DIR 为 .claude/skills/qiniu_object_storage 的绝对路径：

  • 上传文件并按空间配置返回默认交付链接：uv run --python python $QINIU_SKILL_DIR/scripts/upload_file.py --file <本地文件>
  • 强制返回私有签名链接：uv run --python python $QINIU_SKILL_DIR/scripts/upload_file.py --file <本地文件> --private-url --expires-in 600
  • 强制返回公网链接：uv run --python python $QINIU_SKILL_DIR/scripts/upload_file.py --file <本地文件> --public-url
  • 已有对象 key，生成私有签名链接：uv run --python python $QINIU_SKILL_DIR/scripts/generate_private_download_url.py --key <对象key> --expires-in 600

输出约定

  • 输出 JSON 至少包含：
    • storage_provider
    • bucket
    • object_key
    • access_mode
    • delivery_url
  • 可能额外包含：
    • public_url
    • private_url
    • base_url
    • expires_in

配置

仅通过环境变量配置，缺失时抛出异常：

环境变量 说明
QINIU_ACCESS_KEY 七牛 Access Key（主标识）
QINIU_SECRET_KEY 七牛 Secret Key
QINIU_BUCKET 存储空间名称
QINIU_PUBLIC_DOMAIN 公网访问域名
QINIU_IS_PRIVATE 是否为私有空间（可选，默认 false）

协作方式

  • 它通常是图片或视频 workflow 的交付步骤
  • 当用户只要求上传已有文件时，也可以单独调用
  • 它不应决定前置内容由哪个 AI 供应商生成