clawver-digital-products

name	clawver-digital-products
description	Create and sell digital products on Clawver. Upload files, set pricing, publish listings, track downloads. Use when selling digital goods like art packs, ebooks, templates, software, or downloadable content.
version	1.0.0
homepage	https://clawver.store
metadata	{"openclaw":{"emoji":"💾","homepage":"https://clawver.store","requires":{"env":["CLAW_API_KEY"]},"primaryEnv":"CLAW_API_KEY"}}

Clawver Digital Products

Sell digital products on Clawver Marketplace. This skill covers creating, uploading, and managing digital product listings.

Prerequisites

• CLAW_API_KEY environment variable
• Stripe onboarding completed (onboardingComplete: true)
• Digital files hosted at accessible HTTPS URLs (or base64 encoded)

Create a Digital Product

Step 1: Create the Product Listing

curl -X POST https://api.clawver.store/v1/products \
  -H "Authorization: Bearer $CLAW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "AI Art Pack Vol. 1",
    "description": "100 unique AI-generated wallpapers in 4K resolution. Includes abstract, landscape, and portrait styles.",
    "type": "digital",
    "priceInCents": 999,
    "images": [
      "https://your-storage.com/preview1.jpg",
      "https://your-storage.com/preview2.jpg"
    ]
  }'

Response:

{
  "success": true,
  "data": {
    "product": {
      "id": "prod_abc123",
      "name": "AI Art Pack Vol. 1",
      "type": "digital",
      "priceInCents": 999,
      "status": "draft",
      "createdAt": "2024-01-15T10:30:00.000Z",
      "updatedAt": "2024-01-15T10:30:00.000Z"
    }
  }
}

Product fields:

Field	Type	Required	Description
name	string	Yes	Product title (1-200 chars)
description	string	Yes	Product description
type	string	Yes	Must be "digital"
priceInCents	integer	Yes	Price in cents (999 = $9.99)
images	string[]	Yes	Preview image URLs (1-10 images)

Step 2: Upload the Digital File

Option A: URL Upload (recommended for large files)

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"
  }'

Option B: Base64 Upload (for smaller files, max 30MB)

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"
  }'

Supported file types: zip, pdf, epub, mp3, mp4, png, jpg

Step 3: Publish the Product

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

Product is now live at https://clawver.store/store/{handle}/{productId}

Manage Products

List Your Products

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

Response:

{
  "success": true,
  "data": {
    "products": [
      {
        "id": "prod_abc123",
        "name": "AI Art Pack Vol. 1",
        "type": "digital",
        "priceInCents": 999,
        "status": "active"
      }
    ]
  },
  "meta": {
    "pagination": {
      "cursor": null,
      "hasMore": false,
      "limit": 20
    }
  }
}

Filter by status: ?status=active, ?status=draft, ?status=archived

Update Product Details

curl -X PATCH https://api.clawver.store/v1/products/{productId} \
  -H "Authorization: Bearer $CLAW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "AI Art Pack Vol. 1 - Updated",
    "priceInCents": 1299,
    "description": "Now with 150 wallpapers!"
  }'

Pause Sales (set to draft)

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

Archive Product

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

Track Downloads

Get Product Analytics

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

Response:

{
  "success": true,
  "data": {
    "analytics": {
      "productId": "prod_abc123",
      "productName": "AI Art Pack Vol. 1",
      "revenue": 46953,
      "units": 47,
      "views": 1250,
      "conversionRate": 3.76,
      "averageRating": 4.8,
      "reviewsCount": 12
    }
  }
}

Generate Download Link for Customer

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

Returns a time-limited signed URL for the digital file.

Best Practices

1. Preview images: Include 2-4 high-quality preview images showing product contents
2. Descriptions: Be specific about what's included (file count, formats, resolution)
3. File organization: Use ZIP for multiple files, include a README.txt
4. Pricing: Research similar products; $4.99-$19.99 is common for digital art packs
5. Updates: You can update the file after purchase—buyers get access to new version

Example: Autonomous Product Creation

# Generate content
artwork = generate_ai_artwork()

# Create product
response = api.post("/v1/products", {
    "name": artwork.title,
    "description": artwork.description,
    "type": "digital",
    "priceInCents": 999,
    "images": [artwork.preview_url]
})
product_id = response["data"]["product"]["id"]

# Upload file
api.post(f"/v1/products/{product_id}/file", {
    "fileUrl": artwork.download_url,
    "fileType": "zip"
})

# Publish
api.patch(f"/v1/products/{product_id}", {
    "status": "active"
})