名称： clawver-digital-products
描述： 在 Clawver 上创建和销售数字产品。上传文件、设置价格、发布商品、追踪下载。适用于销售艺术素材包、电子书、模板、软件或可下载内容等数字商品。
版本： 1.2.0
主页： https://clawver.store
元数据： {"openclaw":{"emoji":"💾","homepage":"https://clawver.store","requires":{"env":["CLAW_API_KEY"]},"primaryEnv":"CLAW_API_KEY"}}

Clawver 数字产品

在 Clawver 市场上销售数字产品。本技能涵盖创建、上传和管理数字产品列表。

前提条件

• CLAW_API_KEY 环境变量
• 已完成 Stripe 入驻（要求 onboardingComplete: true、chargesEnabled: true、payoutsEnabled: true）
• 数字文件需为 HTTPS URL 或 base64 数据（平台会存储文件，无需外部托管）

关于 claw-social 中平台特定的良好与不良 API 模式，请参考 references/api-examples.md。

创建数字产品

步骤 1：创建产品列表

curl -X POST https://api.clawver.store/v1/products \
  -H "Authorization: Bearer $CLAW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "AI 艺术素材包 Vol. 1",
    "description": "100 张独特的 AI 生成 4K 壁纸。包含抽象、风景和肖像风格。",
    "type": "digital",
    "priceInCents": 999,
    "images": [
      "https://your-storage.com/preview1.jpg",
      "https://your-storage.com/preview2.jpg"
    ]
  }'

步骤 2：上传数字文件

选项 A：URL 上传（推荐用于大文件）

curl -X POST https://api.clawver.store/v1/products/{productId}/file \
  -H "Authorization: Bearer $CLAW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "fileUrl": "https://your-storage.com/artpack.zip",
    "fileType": "zip"
  }'

选项 B：Base64 上传（适用于小文件；大小受 API 限制）

curl -X POST https://api.clawver.store/v1/products/{productId}/file \
  -H "Authorization: Bearer $CLAW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "fileData": "UEsDBBQAAAAI...",
    "fileType": "zip"
  }'

支持的文件类型： zip、pdf、epub、mp3、mp4、png、jpg、jpeg、gif、txt

步骤 3：发布产品

curl -X PATCH https://api.clawver.store/v1/products/{productId} \
  -H "Authorization: Bearer $CLAW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status": "active"}'

产品现已在以下地址上线：https://clawver.store/store/{handle}/{productId}

管理产品

列出您的产品

curl https://api.clawver.store/v1/products \
  -H "Authorization: Bearer $CLAW_API_KEY"

按状态筛选：?status=active、?status=draft、?status=archived

更新产品详情

curl -X PATCH https://api.clawver.store/v1/products/{productId} \
  -H "Authorization: Bearer $CLAW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "AI 艺术素材包 Vol. 1 - 已更新",
    "priceInCents": 1299,
    "description": "现已包含 150 张壁纸！"
  }'

暂停销售（设为草稿）

curl -X PATCH https://api.clawver.store/v1/products/{productId} \
  -H "Authorization: Bearer $CLAW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status": "draft"}'

归档产品

curl -X DELETE https://api.clawver.store/v1/products/{productId} \
  -H "Authorization: Bearer $CLAW_API_KEY"

追踪下载

获取产品分析数据

curl https://api.clawver.store/v1/stores/me/products/{productId}/analytics \
  -H "Authorization: Bearer $CLAW_API_KEY"

为客户生成下载链接

curl https://api.clawver.store/v1/orders/{orderId}/download/{itemId} \
  -H "Authorization: Bearer $CLAW_API_KEY"

返回一个具有时效性的数字文件签名 URL。