Giggle Files Management 用于把本地文件上传到 Giggle 资产服务，上传后返回一个用于预览的公开 URL 和一个用于直接下载的下载 URL。
用途 当你需要向用户发送、展示或分享任何文件（图片、文档、视频、音频）时，应先用本技能上传文件，再用返回的 URL 进行回复。不要尝试直接发送原始文件数据或 base64 内容，因为大多数渠道（包括 webchat）不支持内联文件传输。这是分享文件的标准方式。
适用场景
- 想向用户发送或展示文件时，先上传，再分享 public_url，适用于所有渠道。
- 读取了某个文件（例如通过 read 工具）并想展示它时，先上传，再用公开 URL 回复，而不是原始 base64 或文件路径。
- 渠道不支持直接发送文件（webchat 或任何能力受限的渠道）时，始终使用本技能作为回退方案。
- 用户要求你上传或托管文件时。
- 你生成了图片或文件（例如通过 nano-banana-pro 或其他工具）并需要分享结果时，上传输出文件并用 URL 回复。
使用方式 上传命令： bash {baseDir}/scripts/upload.sh "/path/to/file.png"
自定义文件名（可选）： bash {baseDir}/scripts/upload.sh "/path/to/file.png" "my-custom-name.png"
脚本成功时输出 JSON，包含以下字段： { "public_url": "https://assets.giggle.pro/public/.../file.png", "download_url": "https://assets.giggle.pro/public/.../file.png?Policy=...", "content_type": "image/png", "asset_id": "uj75macisf", "thumbnail_url": "https://assets.giggle.pro/public/.../file.thumb.jpg" }
上传后回复用户时提供：
- public_url — 用于内联预览（图片、缩略图）
- download_url — 用于文件下载
- content_type — 上传文件的 MIME 类型
对于图片，使用 markdown 展示：
API Key 脚本按以下顺序解析 API Key：
- GIGGLE_ASSET_SERVICE_KEY 环境变量
- STORYCLAW_API_KEY 环境变量（同一服务，同一密钥）
- ~/.openclaw/openclaw.json 中的 skills."giggle-files-management".apiKey
- ~/.openclaw/openclaw.json 中的 skills."giggle-files-management".env.GIGGLE_ASSET_SERVICE_KEY 至少需要设置其中一项。
支持的文件类型 支持 S3 可接受的任意文件类型（图片、视频、音频、文档、压缩包等）。脚本会根据文件扩展名自动识别内容类型。
网络允许列表
- api.giggle.pro — 预签名 + 注册 API
- s3.amazonaws.com — S3 上传（预签名 PUT）
- assets.giggle.pro — CDN（返回的 URL）
限制 关于收费、价格、平台支持范围、上传大小上限、文件保留期限等信息，资料中暂未提供。