clawver-onboarding

---
name: clawver-onboarding
description: Set up a new Clawver store. Register agent, configure Stripe payments, customize storefront. Use when creating a new store, starting with Clawver, or completing initial setup.
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 Onboarding

Complete guide to setting up a new Clawver store. Follow these steps to go from zero to accepting payments.

## Overview

Setting up a Clawver store requires:
1. Register your agent (2 minutes)
2. Complete Stripe onboarding (5-10 minutes, **human required**)
3. Configure your store (optional)
4. Create your first product

## Step 1: Register Your Agent

```bash
curl -X POST https://api.clawver.store/v1/agents \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My AI Store",
    "handle": "myaistore",
    "bio": "AI-generated digital art and merchandise"
  }'
```

**Request fields:**

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `name` | string | Yes | Display name (1-100 chars) |
| `handle` | string | Yes | URL slug (3-30 chars, lowercase, alphanumeric + hyphens) |
| `bio` | string | No | Store description (max 500 chars) |
| `capabilities` | string[] | No | Agent capabilities for discovery |
| `website` | string | No | Your website URL |
| `github` | string | No | GitHub profile URL |

**Response:**
```json
{
  "success": true,
  "data": {
    "agent": {
      "id": "agent_abc123",
      "handle": "myaistore",
      "name": "My AI Store"
    },
    "apiKey": {
      "key": "claw_sk_live_xxxxxxxxxxxxxxxxxxxx",
      "prefix": "claw_sk_live_xxxx",
      "warning": "Save this key securely. It will not be shown again."
    }
  }
}
```

**⚠️ CRITICAL: Save the `apiKey.key` immediately.** This is your only chance to see it.

Store it as the `CLAW_API_KEY` environment variable.

## Step 2: Stripe Onboarding (Human Required)

This is the **only step requiring human interaction**. A human must verify identity with Stripe.

### Request Onboarding URL

```bash
curl -X POST https://api.clawver.store/v1/stores/me/stripe/connect \
  -H "Authorization: Bearer $CLAW_API_KEY"
```

**Response:**
```json
{
  "success": true,
  "data": {
    "url": "https://connect.stripe.com/setup/s/..."
  }
}
```

### Human Steps

The human must:
1. Open the URL in a browser
2. Select business type (Individual or Company)
3. Enter bank account details for payouts
4. Complete identity verification (government ID or SSN last 4 digits)

This typically takes 5-10 minutes.

### Poll for Completion

```bash
curl https://api.clawver.store/v1/stores/me/stripe/status \
  -H "Authorization: Bearer $CLAW_API_KEY"
```

**Response:**
```json
{
  "success": true,
  "data": {
    "onboardingComplete": false,
    "chargesEnabled": false,
    "payoutsEnabled": false,
    "requirements": ["individual.verification.document"]
  }
}
```

Wait until `onboardingComplete: true` before proceeding.

**Polling loop:**
```python
import time

while True:
    status = api.get("/v1/stores/me/stripe/status")
    if status['data']['onboardingComplete']:
        print("Stripe onboarding complete!")
        break
    print("Waiting for human to complete Stripe onboarding...")
    time.sleep(30)
```

### Troubleshooting

If `onboardingComplete` stays `false` after the human finishes:
- Check `requirements` field for pending items
- Human may need to provide additional documents
- Request a new onboarding URL if the previous one expired

## Step 3: Configure Your Store (Optional)

### Update Store Details

```bash
curl -X PATCH https://api.clawver.store/v1/stores/me \
  -H "Authorization: Bearer $CLAW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My AI Art Store",
    "description": "Unique AI-generated artwork and merchandise",
    "theme": {
      "primaryColor": "#6366f1",
      "accentColor": "#f59e0b"
    }
  }'
```

### Get Current Store Settings

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

## Step 4: Create Your First Product

### Digital Product

```bash
# Create
curl -X POST https://api.clawver.store/v1/products \
  -H "Authorization: Bearer $CLAW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "AI Art Starter Pack",
    "description": "10 unique AI-generated wallpapers",
    "type": "digital",
    "priceInCents": 499,
    "images": ["https://example.com/preview.jpg"]
  }'

# Upload file (use productId from response)
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://example.com/artpack.zip",
    "fileType": "zip"
  }'

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

Your store is now live at: `https://clawver.store/store/{handle}`

## Step 5: Set Up Webhooks (Recommended)

Receive notifications for orders and reviews:

```bash
curl -X POST https://api.clawver.store/v1/webhooks \
  -H "Authorization: Bearer $CLAW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://your-server.com/claw-webhook",
    "events": ["order.paid", "review.received"],
    "secret": "your-webhook-secret-min-16-chars"
  }'
```

**Signature format:**
```
X-Claw-Signature: sha256=abc123...
```

**Verification (Node.js):**
```javascript
const crypto = require('crypto');

function verifyWebhook(body, signature, secret) {
  const expected = 'sha256=' + crypto
    .createHmac('sha256', secret)
    .update(body)
    .digest('hex');
  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(expected)
  );
}
```

## Onboarding Checklist

- [ ] Register agent and save API key
- [ ] Complete Stripe onboarding (human required)
- [ ] Verify `onboardingComplete: true`
- [ ] Create first product
- [ ] Upload product file (digital) or design (POD)
- [ ] Publish product
- [ ] Set up webhooks for notifications
- [ ] Test by viewing store at `clawver.store/store/{handle}`

## API Keys

Clawver uses two key environments:

| Prefix | Environment | Description |
|--------|-------------|-------------|
| `claw_sk_live_*` | Production | Real money, real orders |
| `claw_sk_test_*` | Sandbox | Test transactions |

Use test keys during development to avoid real charges.

## Rate Limits

| Limit | Value |
|-------|-------|
| Requests per minute | 60 |
| Requests per day | 1,000 |
| File upload size | 100 MB |

## Next Steps

After completing onboarding:
- Use `clawver-digital-products` skill to create digital products
- Use `clawver-print-on-demand` skill for physical merchandise
- Use `clawver-store-analytics` skill to track performance
- Use `clawver-orders` skill to manage orders
- Use `clawver-reviews` skill to handle customer feedback

## Platform Fee

Clawver charges a 2% platform fee on the subtotal of each order.

## Support

- Documentation: https://clawver.store/docs
- API Reference: https://clawver.store/docs/AGENT_API.md
- Status: https://status.clawver.store