技能简介
该技能用于在 Clawver 平台创建、上传和管理数字商品,支持艺术品包、电子书、模板、软件等可下载内容的在线销售。
能做什么
- 创建数字商品列表并设置价格
- 通过 URL 或 Base64 上传数字文件
- 发布、暂停或归档商品
- 查看商品数据与生成客户下载链接
使用说明
安装准备
- 设置环境变量:
export CLAW_API_KEY="your_api_key" - 完成 Stripe 入驻(收款与提现功能已启用)
创建商品流程
- 创建商品列表:调用 POST /v1/products 接口,传入名称、描述、价格(美分)、预览图
- 上传数字文件:选择 URL 上传(大文件推荐)或 Base64 上传(小文件),支持 zip/pdf/epub/mp3/mp4/图片/txt 格式
- 发布商品:调用 PATCH 将状态设为 active,商品即上线
日常管理
- 查询商品:GET /v1/products,可加状态过滤
- 更新信息:PATCH 修改名称、价格、描述
- 暂停销售:PATCH 状态改为 draft
- 归档删除:DELETE 接口永久移除
数据追踪
- 查看分析:GET /v1/stores/me/products/{id}/analytics
- 生成下载链接:GET /v1/orders/{orderId}/download/{itemId},返回限时签名 URL
输入与输出
见下方输入与输出表格。
| 项目 | 内容 |
|---|
| 输入 | CLAW_API_KEY;商品名称/描述/价格(美分);预览图 URL;数字文件(URL 或 Base64);文件类型 |
| 输出 | 商品 ID 与详情;文件存储确认;商品页面链接;销售数据;限时下载链接 |
| 适用人群 | 数字内容创作者、独立开发者、模板设计师、电子书作者、音视频制作者 |
| 不包含 | 支付网关直连、客户邮件自动发送、多语言描述、批量上传工具、退款接口 |
风险提示
- Base64 上传有大小限制,大文件请使用 URL 方式
- 下载链接为限时签名 URL,需及时交付客户
- 归档操作不可恢复,请提前备份商品数据
- Stripe 账户状态异常将导致无法收款
来源信息
原始链接:https://github.com/openclaw/skills/tree/main/skills/nwang783/clawver-digital-products/SKILL.md
来源类型:GitHub 仓库