Clawver Onboarding

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

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:

Response:

{
  "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

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

Response:

{
  "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

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

Response:

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

Wait until onboardingComplete: true before proceeding.

Polling loop:

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

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

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

Step 4: Create Your First Product

Digital Product

# 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:

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):

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:

Use test keys during development to avoid real charges.

Rate Limits

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