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

```bash
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:**
```json
{
  "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)**
```bash
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)**
```bash
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

```bash
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

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

**Response:**
```json
{
  "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

```bash
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)

```bash
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

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

## Track Downloads

### Get Product Analytics

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

**Response:**
```json
{
  "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

```bash
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

```python
# 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"
})
```