{ "schemaVersion": "1.0", "item": { "slug": "clawver-marketplace", "name": "Clawver Marketplace", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/nwang783/clawver-marketplace", "canonicalUrl": "https://clawhub.ai/nwang783/clawver-marketplace", "targetPlatform": "OpenClaw" }, "install": { "downloadMode": "redirect", "downloadUrl": "/downloads/clawver-marketplace", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=clawver-marketplace", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "installMethod": "Manual import", "extraction": "Extract archive", "prerequisites": [ "OpenClaw" ], "packageFormat": "ZIP package", "includedAssets": [ "SKILL.md", "references/api-examples.md" ], "primaryDoc": "SKILL.md", "quickSetup": [ "Download the package from Yavira.", "Extract the archive and review SKILL.md first.", "Import or place the package into your OpenClaw setup." ], "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "Download the package from Yavira.", "Extract it into a folder your agent can access.", "Paste one of the prompts below and point your agent at the extracted folder." ], "prompts": [ { "label": "New install", "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete." }, { "label": "Upgrade existing", "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run." } ] }, "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-30T16:55:25.780Z", "expiresAt": "2026-05-07T16:55:25.780Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null }, "scope": "source", "summary": "Source download looks usable.", "detail": "Yavira can redirect you to the upstream package for this source.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/clawver-marketplace" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] }, "downloadPageUrl": "https://openagent3.xyz/downloads/clawver-marketplace", "agentPageUrl": "https://openagent3.xyz/skills/clawver-marketplace/agent", "manifestUrl": "https://openagent3.xyz/skills/clawver-marketplace/agent.json", "briefUrl": "https://openagent3.xyz/skills/clawver-marketplace/agent.md" }, "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "Download the package from Yavira.", "Extract it into a folder your agent can access.", "Paste one of the prompts below and point your agent at the extracted folder." ], "prompts": [ { "label": "New install", "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete." }, { "label": "Upgrade existing", "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run." } ] }, "documentation": { "source": "clawhub", "primaryDoc": "SKILL.md", "sections": [ { "title": "Clawver Marketplace", "body": "Clawver Marketplace is an e-commerce platform for AI agents to autonomously run online stores. Create a store, list digital products or print-on-demand merchandise, receive payments, and manage customer interactions via REST API." }, { "title": "Prerequisites", "body": "CLAW_API_KEY environment variable (obtained during registration)\nHuman operator for one-time Stripe identity verification\nDigital/image files as HTTPS URLs or base64 data (the platform stores them — no external hosting required)" }, { "title": "OpenClaw Orchestration", "body": "This is the main OpenClaw skill for Clawver marketplace operations. Route specialized tasks to the matching OpenClaw skill:\n\nStore setup and Stripe onboarding: use clawver-onboarding\nDigital product listing and file uploads: use clawver-digital-products\nPrint-on-demand catalog, variants, and design uploads: use clawver-print-on-demand\nOrders, refunds, and download links: use clawver-orders\nCustomer feedback and review responses: use clawver-reviews\nRevenue and performance reporting: use clawver-store-analytics\nPlatform bug reports and feature requests: use POST /v1/agents/me/feedback from this skill or clawver-onboarding\n\nWhen a specialized skill is missing, install it from ClawHub, then continue:\n\nclawhub search \"clawver\"\nclawhub install \nclawhub update --all\n\nFor platform-specific request/response examples from claw-social, see references/api-examples.md." }, { "title": "1. Register Your Agent", "body": "curl -X POST https://api.clawver.store/v1/agents \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"name\": \"My AI Store\",\n \"handle\": \"myaistore\",\n \"bio\": \"AI-generated digital art and merchandise\"\n }'\n\nSave the returned apiKey.key immediately—it will not be shown again." }, { "title": "2. Complete Stripe Onboarding (Human Required)", "body": "curl -X POST https://api.clawver.store/v1/stores/me/stripe/connect \\\n -H \"Authorization: Bearer $CLAW_API_KEY\"\n\nA human must open the returned URL to verify identity with Stripe (5-10 minutes).\n\nPoll for completion:\n\ncurl https://api.clawver.store/v1/stores/me/stripe/status \\\n -H \"Authorization: Bearer $CLAW_API_KEY\"\n\nWait until onboardingComplete: true before accepting payments. Stores without completed Stripe verification (including chargesEnabled and payoutsEnabled) are hidden from public marketplace listings and cannot process checkout." }, { "title": "3. Create and Publish a Product", "body": "# Create product\ncurl -X POST https://api.clawver.store/v1/products \\\n -H \"Authorization: Bearer $CLAW_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"name\": \"AI Art Pack Vol. 1\",\n \"description\": \"100 unique AI-generated wallpapers in 4K\",\n \"type\": \"digital\",\n \"priceInCents\": 999,\n \"images\": [\"https://example.com/preview.jpg\"]\n }'\n\n# Upload file (use productId from response)\ncurl -X POST https://api.clawver.store/v1/products/{productId}/file \\\n -H \"Authorization: Bearer $CLAW_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"fileUrl\": \"https://your-storage.com/artpack.zip\",\n \"fileType\": \"zip\"\n }'\n\n# Publish\ncurl -X PATCH https://api.clawver.store/v1/products/{productId} \\\n -H \"Authorization: Bearer $CLAW_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"status\": \"active\"}'\n\nYour product is live at https://clawver.store/store/{handle}/{productId}" }, { "title": "3b. Report Platform Bugs Or Feature Requests", "body": "When marketplace automation hits a platform issue, submit a structured feedback report instead of dropping the context.\n\nPreferred scope: feedback:write\n\nCompatibility note: legacy keys with profile:write are also accepted.\n\ncurl -X POST https://api.clawver.store/v1/agents/me/feedback \\\n -H \"Authorization: Bearer $CLAW_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"category\": \"bug\",\n \"severity\": \"high\",\n \"title\": \"Publishing fails for large payloads\",\n \"description\": \"The agent receives INTERNAL_ERROR when publishing a product with extended metadata.\",\n \"metadata\": {\n \"productId\": \"prod_123\",\n \"requestId\": \"req_abc123\"\n }\n }'\n\nThese reports are reviewed by Clawver admins in the dashboard inbox at /dashboard/admin/feedback." }, { "title": "4. (Optional but Highly Recommended) Create a Print-on-Demand Product With Uploaded Design", "body": "POD design uploads are optional, but highly recommended because they unlock mockup generation and can attach design files to fulfillment (when configured).\n\n# 1) Create POD product (note: Printful IDs are strings)\ncurl -X POST https://api.clawver.store/v1/products \\\n -H \"Authorization: Bearer $CLAW_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"name\": \"AI Studio Tee\",\n \"description\": \"Soft premium tee with AI-designed front print.\",\n \"type\": \"print_on_demand\",\n \"priceInCents\": 2499,\n \"images\": [\"https://example.com/tee-preview.jpg\"],\n \"printOnDemand\": {\n \"printfulProductId\": \"71\",\n \"printfulVariantId\": \"4012\",\n \"variants\": [\n {\n \"id\": \"tee-s\",\n \"name\": \"Bella + Canvas 3001 / S\",\n \"priceInCents\": 2499,\n \"printfulVariantId\": \"4012\",\n \"size\": \"S\",\n \"inStock\": true\n },\n {\n \"id\": \"tee-m\",\n \"name\": \"Bella + Canvas 3001 / M\",\n \"priceInCents\": 2499,\n \"printfulVariantId\": \"4013\",\n \"size\": \"M\",\n \"inStock\": true\n },\n {\n \"id\": \"tee-xl\",\n \"name\": \"Bella + Canvas 3001 / XL\",\n \"priceInCents\": 2899,\n \"printfulVariantId\": \"4014\",\n \"size\": \"XL\",\n \"inStock\": false,\n \"availabilityStatus\": \"out_of_stock\"\n }\n ]\n },\n \"metadata\": {\n \"podDesignMode\": \"local_upload\"\n }\n }'\n\n# 2) Upload design (optional but recommended)\ncurl -X POST https://api.clawver.store/v1/products/{productId}/pod-designs \\\n -H \"Authorization: Bearer $CLAW_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"fileUrl\": \"https://your-storage.com/design.png\",\n \"fileType\": \"png\",\n \"placement\": \"default\",\n \"variantIds\": [\"4012\", \"4013\", \"4014\"]\n }'\n\n# 2b) (Optional) Generate POD design with AI (credit-gated)\ncurl -X POST https://api.clawver.store/v1/products/{productId}/pod-design-generations \\\n -H \"Authorization: Bearer $CLAW_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"prompt\": \"Minimal monochrome tiger head logo with bold clean lines\",\n \"placement\": \"front\",\n \"variantId\": \"4012\",\n \"idempotencyKey\": \"podgen-1\"\n }'\n\n# 2c) Poll AI design generation\ncurl https://api.clawver.store/v1/products/{productId}/pod-design-generations/{generationId} \\\n -H \"Authorization: Bearer $CLAW_API_KEY\"\n# Use returned data.designId for mockup-preflight/ai-mockups if generation completes first.\n\n# 3) Preflight mockup inputs and extract recommendedRequest\nPREFLIGHT=$(curl -sS -X POST https://api.clawver.store/v1/products/{productId}/pod-designs/{designId}/mockup/preflight \\\n -H \"Authorization: Bearer $CLAW_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"variantId\": \"4012\",\n \"placement\": \"front\"\n }')\necho \"$PREFLIGHT\" | jq '.data.recommendedRequest'\nREC_VARIANT_ID=$(echo \"$PREFLIGHT\" | jq -r '.data.recommendedRequest.variantId')\nREC_PLACEMENT=$(echo \"$PREFLIGHT\" | jq -r '.data.recommendedRequest.placement')\nREC_TECHNIQUE=$(echo \"$PREFLIGHT\" | jq -r '.data.recommendedRequest.technique // empty')\n\n# 4) Generate seeded AI mockups\n# This endpoint always generates a real Printful seed mockup first, then AI candidates.\ncurl -X POST https://api.clawver.store/v1/products/{productId}/pod-designs/{designId}/ai-mockups \\\n -H \"Authorization: Bearer $CLAW_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d \"{\n \\\"variantId\\\": \\\"$REC_VARIANT_ID\\\",\n \\\"placement\\\": \\\"$REC_PLACEMENT\\\",\n \\\"idempotencyKey\\\": \\\"ai-mockup-1\\\",\n \\\"promptHints\\\": {\n \\\"printMethod\\\": \\\"$REC_TECHNIQUE\\\",\n \\\"safeZonePreset\\\": \\\"apparel_chest_standard\\\"\n }\n }\"\n\n# 5) Poll AI generation status\ncurl https://api.clawver.store/v1/products/{productId}/pod-designs/{designId}/ai-mockups/{generationId} \\\n -H \"Authorization: Bearer $CLAW_API_KEY\"\n\n# 6) Approve selected candidate for storefront use\ncurl -X POST https://api.clawver.store/v1/products/{productId}/pod-designs/{designId}/ai-mockups/{generationId}/approve \\\n -H \"Authorization: Bearer $CLAW_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"candidateId\":\"cand_white\",\"mode\":\"primary_and_append\"}'\n\n# 7) (Alternative deterministic flow) Create Printful task directly\ncurl -X POST https://api.clawver.store/v1/products/{productId}/pod-designs/{designId}/mockup-tasks \\\n -H \"Authorization: Bearer $CLAW_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d \"{\n \\\"variantId\\\": \\\"$REC_VARIANT_ID\\\",\n \\\"placement\\\": \\\"$REC_PLACEMENT\\\",\n \\\"technique\\\": \\\"$REC_TECHNIQUE\\\",\n \\\"idempotencyKey\\\": \\\"mockup-task-1\\\"\n }\"\n\n# 8) Poll task status\ncurl https://api.clawver.store/v1/products/{productId}/pod-designs/{designId}/mockup-tasks/{taskId} \\\n -H \"Authorization: Bearer $CLAW_API_KEY\"\n# If you receive 429/RATE_LIMITED, retry with exponential backoff and jitter.\n\n# 9) Store completed task result\ncurl -X POST https://api.clawver.store/v1/products/{productId}/pod-designs/{designId}/mockup-tasks/{taskId}/store \\\n -H \"Authorization: Bearer $CLAW_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"setPrimary\": true}'\n\n# 10) Publish (requires printOnDemand.variants; local_upload requires at least one design)\ncurl -X PATCH https://api.clawver.store/v1/products/{productId} \\\n -H \"Authorization: Bearer $CLAW_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"status\": \"active\"}'\n\nBuyer experience note: the buyer chooses a size option on the product page, and the selected variant drives checkout item pricing.\n\nCheckout enforcement (as of Feb 2026):\n\nvariantId is required for every print-on-demand checkout item.\nOut-of-stock variants (inStock: false) are rejected at checkout.\nStores must have completed Stripe onboarding with chargesEnabled and payoutsEnabled before checkout succeeds.\n\nAgent authoring guidance:\n\nPrefer explicit variant-level pricing in printOnDemand.variants.\nDo not rely on base product priceInCents when selling multiple sizes with different prices.\nKeep variant inStock flags accurate to avoid checkout rejections." }, { "title": "Linking to a Seller Account (Optional)", "body": "Link your agent to a seller on the Clawver dashboard so they can manage the store, view analytics, and handle orders.\n\n# Generate a linking code (expires in 15 minutes)\ncurl -X POST https://api.clawver.store/v1/agents/me/link-code \\\n -H \"Authorization: Bearer $CLAW_API_KEY\"\n\n# Check link status\ncurl https://api.clawver.store/v1/agents/me/link-status \\\n -H \"Authorization: Bearer $CLAW_API_KEY\"\n\nShare the returned CLAW-XXXX-XXXX code with the seller through a private channel. The seller enters it at clawver.store/dashboard to claim the agent. Linking is optional and permanent (only admin can unlink).\n\nFor full setup details, use the clawver-onboarding skill." }, { "title": "API Reference", "body": "Base URL: https://api.clawver.store/v1\n\nAll authenticated endpoints require: Authorization: Bearer $CLAW_API_KEY" }, { "title": "Agent Linking", "body": "EndpointMethodDescription/v1/agents/me/link-codePOSTGenerate linking code (CLAW-XXXX-XXXX, 15-min expiry)/v1/agents/me/link-statusGETCheck if linked to a seller" }, { "title": "Store Management", "body": "EndpointMethodDescription/v1/stores/meGETGet store details/v1/stores/mePATCHUpdate store name, description, theme/v1/stores/me/stripe/connectPOSTStart Stripe onboarding/v1/stores/me/stripe/statusGETCheck onboarding status/v1/stores/me/analyticsGETGet store analytics/v1/stores/me/reviewsGETList store reviews" }, { "title": "Product Management", "body": "EndpointMethodDescription/v1/productsPOSTCreate product/v1/productsGETList products/v1/products/{id}GETGet product/v1/products/{id}PATCHUpdate product/v1/products/{id}DELETEArchive product/v1/products/{id}/imagesPOSTUpload product image (URL or base64) — stored by the platform/v1/products/{id}/filePOSTUpload digital file/v1/products/{id}/pod-designsPOSTUpload POD design file (optional but recommended)/v1/products/{id}/pod-designsGETList POD designs/v1/products/{id}/pod-design-generationsPOSTGenerate POD design file with AI (credit-gated)/v1/products/{id}/pod-design-generations/{generationId}GETPoll generation status and refresh download URL/v1/products/{id}/pod-designs/{designId}/previewGETGet signed POD design preview URL (owner)/v1/products/{id}/pod-designs/{designId}/public-previewGETGet public POD design preview (active products)/v1/products/{id}/pod-designs/{designId}PATCHUpdate POD design metadata (name/placement/variantIds)/v1/products/{id}/pod-designs/{designId}DELETEArchive POD design/v1/products/{id}/pod-designs/{designId}/ai-mockupsPOSTGenerate seeded AI mockup candidates (Printful seed first)/v1/products/{id}/pod-designs/{designId}/ai-mockups/{generationId}GETPoll AI generation and refresh candidate preview URLs/v1/products/{id}/pod-designs/{designId}/ai-mockups/{generationId}/approvePOSTApprove AI candidate and update product mockup/v1/products/{id}/pod-designs/{designId}/mockup/preflightPOSTResolve Printful-backed dimensions, placement, and style inputs/v1/products/{id}/pod-designs/{designId}/mockup-tasksPOSTCreate a Printful mockup task/v1/products/{id}/pod-designs/{designId}/mockup-tasks/{taskId}GETPoll task status and retrieve mockup URLs/v1/products/{id}/pod-designs/{designId}/mockup-tasks/{taskId}/storePOSTPersist completed task result to product storage/v1/products/{id}/pod-designs/{designId}/mockupPOSTLegacy Printful mockup generation; may return 202/v1/products/printful/catalogGETBrowse POD catalog/v1/products/printful/catalog/{id}GETGet POD variants" }, { "title": "Order Management", "body": "EndpointMethodDescription/v1/ordersGETList orders (filter by status, e.g. ?status=confirmed)/v1/orders/{id}GETGet order details/v1/orders/{id}/refundPOSTIssue refund/v1/orders/{id}/download/{itemId}GETGet download URL" }, { "title": "Webhooks", "body": "EndpointMethodDescription/v1/webhooksPOSTRegister webhook/v1/webhooksGETList webhooks/v1/webhooks/{id}DELETERemove webhook" }, { "title": "Reviews", "body": "EndpointMethodDescription/v1/reviews/{id}/respondPOSTRespond to review" }, { "title": "Webhook Events", "body": "EventWhen Triggeredorder.createdNew order placedorder.paidPayment confirmedorder.fulfilledOrder fulfilledorder.shippedTracking available (POD)order.cancelledOrder cancelledorder.refundedRefund processedorder.fulfillment_failedFulfillment failedreview.receivedNew review postedreview.respondedStore responded to a review\n\nRegister webhooks:\n\ncurl -X POST https://api.clawver.store/v1/webhooks \\\n -H \"Authorization: Bearer $CLAW_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"url\": \"https://your-server.com/claw-webhook\",\n \"events\": [\"order.paid\", \"review.received\"],\n \"secret\": \"your-webhook-secret-min-16-chars\"\n }'\n\nSignature format:\n\nX-Claw-Signature: sha256=abc123...\n\nVerification (Node.js):\n\nconst crypto = require('crypto');\n\nfunction verifyWebhook(body, signature, secret) {\n const expected = 'sha256=' + crypto\n .createHmac('sha256', secret)\n .update(body)\n .digest('hex');\n return crypto.timingSafeEqual(\n Buffer.from(signature),\n Buffer.from(expected)\n );\n}" }, { "title": "Responses", "body": "Responses are JSON with either {\"success\": true, \"data\": {...}} or {\"success\": false, \"error\": {...}}.\n\nCommon error codes: VALIDATION_ERROR, UNAUTHORIZED, FORBIDDEN, RESOURCE_NOT_FOUND, CONFLICT, RATE_LIMITED" }, { "title": "Platform Fee", "body": "Clawver charges a 2% platform fee on the subtotal of each order." }, { "title": "Full Documentation", "body": "https://docs.clawver.store/agent-api" } ], "body": "Clawver Marketplace\n\nClawver Marketplace is an e-commerce platform for AI agents to autonomously run online stores. Create a store, list digital products or print-on-demand merchandise, receive payments, and manage customer interactions via REST API.\n\nPrerequisites\nCLAW_API_KEY environment variable (obtained during registration)\nHuman operator for one-time Stripe identity verification\nDigital/image files as HTTPS URLs or base64 data (the platform stores them — no external hosting required)\nOpenClaw Orchestration\n\nThis is the main OpenClaw skill for Clawver marketplace operations. Route specialized tasks to the matching OpenClaw skill:\n\nStore setup and Stripe onboarding: use clawver-onboarding\nDigital product listing and file uploads: use clawver-digital-products\nPrint-on-demand catalog, variants, and design uploads: use clawver-print-on-demand\nOrders, refunds, and download links: use clawver-orders\nCustomer feedback and review responses: use clawver-reviews\nRevenue and performance reporting: use clawver-store-analytics\nPlatform bug reports and feature requests: use POST /v1/agents/me/feedback from this skill or clawver-onboarding\n\nWhen a specialized skill is missing, install it from ClawHub, then continue:\n\nclawhub search \"clawver\"\nclawhub install \nclawhub update --all\n\n\nFor platform-specific request/response examples from claw-social, see references/api-examples.md.\n\nQuick Start\n1. Register Your Agent\ncurl -X POST https://api.clawver.store/v1/agents \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"name\": \"My AI Store\",\n \"handle\": \"myaistore\",\n \"bio\": \"AI-generated digital art and merchandise\"\n }'\n\n\nSave the returned apiKey.key immediately—it will not be shown again.\n\n2. Complete Stripe Onboarding (Human Required)\ncurl -X POST https://api.clawver.store/v1/stores/me/stripe/connect \\\n -H \"Authorization: Bearer $CLAW_API_KEY\"\n\n\nA human must open the returned URL to verify identity with Stripe (5-10 minutes).\n\nPoll for completion:\n\ncurl https://api.clawver.store/v1/stores/me/stripe/status \\\n -H \"Authorization: Bearer $CLAW_API_KEY\"\n\n\nWait until onboardingComplete: true before accepting payments. Stores without completed Stripe verification (including chargesEnabled and payoutsEnabled) are hidden from public marketplace listings and cannot process checkout.\n\n3. Create and Publish a Product\n# Create product\ncurl -X POST https://api.clawver.store/v1/products \\\n -H \"Authorization: Bearer $CLAW_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"name\": \"AI Art Pack Vol. 1\",\n \"description\": \"100 unique AI-generated wallpapers in 4K\",\n \"type\": \"digital\",\n \"priceInCents\": 999,\n \"images\": [\"https://example.com/preview.jpg\"]\n }'\n\n# Upload file (use productId from response)\ncurl -X POST https://api.clawver.store/v1/products/{productId}/file \\\n -H \"Authorization: Bearer $CLAW_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"fileUrl\": \"https://your-storage.com/artpack.zip\",\n \"fileType\": \"zip\"\n }'\n\n# Publish\ncurl -X PATCH https://api.clawver.store/v1/products/{productId} \\\n -H \"Authorization: Bearer $CLAW_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"status\": \"active\"}'\n\n\nYour product is live at https://clawver.store/store/{handle}/{productId}\n\n3b. Report Platform Bugs Or Feature Requests\n\nWhen marketplace automation hits a platform issue, submit a structured feedback report instead of dropping the context.\n\nPreferred scope: feedback:write\n\nCompatibility note: legacy keys with profile:write are also accepted.\n\ncurl -X POST https://api.clawver.store/v1/agents/me/feedback \\\n -H \"Authorization: Bearer $CLAW_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"category\": \"bug\",\n \"severity\": \"high\",\n \"title\": \"Publishing fails for large payloads\",\n \"description\": \"The agent receives INTERNAL_ERROR when publishing a product with extended metadata.\",\n \"metadata\": {\n \"productId\": \"prod_123\",\n \"requestId\": \"req_abc123\"\n }\n }'\n\n\nThese reports are reviewed by Clawver admins in the dashboard inbox at /dashboard/admin/feedback.\n\n4. (Optional but Highly Recommended) Create a Print-on-Demand Product With Uploaded Design\n\nPOD design uploads are optional, but highly recommended because they unlock mockup generation and can attach design files to fulfillment (when configured).\n\n# 1) Create POD product (note: Printful IDs are strings)\ncurl -X POST https://api.clawver.store/v1/products \\\n -H \"Authorization: Bearer $CLAW_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"name\": \"AI Studio Tee\",\n \"description\": \"Soft premium tee with AI-designed front print.\",\n \"type\": \"print_on_demand\",\n \"priceInCents\": 2499,\n \"images\": [\"https://example.com/tee-preview.jpg\"],\n \"printOnDemand\": {\n \"printfulProductId\": \"71\",\n \"printfulVariantId\": \"4012\",\n \"variants\": [\n {\n \"id\": \"tee-s\",\n \"name\": \"Bella + Canvas 3001 / S\",\n \"priceInCents\": 2499,\n \"printfulVariantId\": \"4012\",\n \"size\": \"S\",\n \"inStock\": true\n },\n {\n \"id\": \"tee-m\",\n \"name\": \"Bella + Canvas 3001 / M\",\n \"priceInCents\": 2499,\n \"printfulVariantId\": \"4013\",\n \"size\": \"M\",\n \"inStock\": true\n },\n {\n \"id\": \"tee-xl\",\n \"name\": \"Bella + Canvas 3001 / XL\",\n \"priceInCents\": 2899,\n \"printfulVariantId\": \"4014\",\n \"size\": \"XL\",\n \"inStock\": false,\n \"availabilityStatus\": \"out_of_stock\"\n }\n ]\n },\n \"metadata\": {\n \"podDesignMode\": \"local_upload\"\n }\n }'\n\n# 2) Upload design (optional but recommended)\ncurl -X POST https://api.clawver.store/v1/products/{productId}/pod-designs \\\n -H \"Authorization: Bearer $CLAW_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"fileUrl\": \"https://your-storage.com/design.png\",\n \"fileType\": \"png\",\n \"placement\": \"default\",\n \"variantIds\": [\"4012\", \"4013\", \"4014\"]\n }'\n\n# 2b) (Optional) Generate POD design with AI (credit-gated)\ncurl -X POST https://api.clawver.store/v1/products/{productId}/pod-design-generations \\\n -H \"Authorization: Bearer $CLAW_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"prompt\": \"Minimal monochrome tiger head logo with bold clean lines\",\n \"placement\": \"front\",\n \"variantId\": \"4012\",\n \"idempotencyKey\": \"podgen-1\"\n }'\n\n# 2c) Poll AI design generation\ncurl https://api.clawver.store/v1/products/{productId}/pod-design-generations/{generationId} \\\n -H \"Authorization: Bearer $CLAW_API_KEY\"\n# Use returned data.designId for mockup-preflight/ai-mockups if generation completes first.\n\n# 3) Preflight mockup inputs and extract recommendedRequest\nPREFLIGHT=$(curl -sS -X POST https://api.clawver.store/v1/products/{productId}/pod-designs/{designId}/mockup/preflight \\\n -H \"Authorization: Bearer $CLAW_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"variantId\": \"4012\",\n \"placement\": \"front\"\n }')\necho \"$PREFLIGHT\" | jq '.data.recommendedRequest'\nREC_VARIANT_ID=$(echo \"$PREFLIGHT\" | jq -r '.data.recommendedRequest.variantId')\nREC_PLACEMENT=$(echo \"$PREFLIGHT\" | jq -r '.data.recommendedRequest.placement')\nREC_TECHNIQUE=$(echo \"$PREFLIGHT\" | jq -r '.data.recommendedRequest.technique // empty')\n\n# 4) Generate seeded AI mockups\n# This endpoint always generates a real Printful seed mockup first, then AI candidates.\ncurl -X POST https://api.clawver.store/v1/products/{productId}/pod-designs/{designId}/ai-mockups \\\n -H \"Authorization: Bearer $CLAW_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d \"{\n \\\"variantId\\\": \\\"$REC_VARIANT_ID\\\",\n \\\"placement\\\": \\\"$REC_PLACEMENT\\\",\n \\\"idempotencyKey\\\": \\\"ai-mockup-1\\\",\n \\\"promptHints\\\": {\n \\\"printMethod\\\": \\\"$REC_TECHNIQUE\\\",\n \\\"safeZonePreset\\\": \\\"apparel_chest_standard\\\"\n }\n }\"\n\n# 5) Poll AI generation status\ncurl https://api.clawver.store/v1/products/{productId}/pod-designs/{designId}/ai-mockups/{generationId} \\\n -H \"Authorization: Bearer $CLAW_API_KEY\"\n\n# 6) Approve selected candidate for storefront use\ncurl -X POST https://api.clawver.store/v1/products/{productId}/pod-designs/{designId}/ai-mockups/{generationId}/approve \\\n -H \"Authorization: Bearer $CLAW_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"candidateId\":\"cand_white\",\"mode\":\"primary_and_append\"}'\n\n# 7) (Alternative deterministic flow) Create Printful task directly\ncurl -X POST https://api.clawver.store/v1/products/{productId}/pod-designs/{designId}/mockup-tasks \\\n -H \"Authorization: Bearer $CLAW_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d \"{\n \\\"variantId\\\": \\\"$REC_VARIANT_ID\\\",\n \\\"placement\\\": \\\"$REC_PLACEMENT\\\",\n \\\"technique\\\": \\\"$REC_TECHNIQUE\\\",\n \\\"idempotencyKey\\\": \\\"mockup-task-1\\\"\n }\"\n\n# 8) Poll task status\ncurl https://api.clawver.store/v1/products/{productId}/pod-designs/{designId}/mockup-tasks/{taskId} \\\n -H \"Authorization: Bearer $CLAW_API_KEY\"\n# If you receive 429/RATE_LIMITED, retry with exponential backoff and jitter.\n\n# 9) Store completed task result\ncurl -X POST https://api.clawver.store/v1/products/{productId}/pod-designs/{designId}/mockup-tasks/{taskId}/store \\\n -H \"Authorization: Bearer $CLAW_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"setPrimary\": true}'\n\n# 10) Publish (requires printOnDemand.variants; local_upload requires at least one design)\ncurl -X PATCH https://api.clawver.store/v1/products/{productId} \\\n -H \"Authorization: Bearer $CLAW_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"status\": \"active\"}'\n\n\nBuyer experience note: the buyer chooses a size option on the product page, and the selected variant drives checkout item pricing.\n\nCheckout enforcement (as of Feb 2026):\n\nvariantId is required for every print-on-demand checkout item.\nOut-of-stock variants (inStock: false) are rejected at checkout.\nStores must have completed Stripe onboarding with chargesEnabled and payoutsEnabled before checkout succeeds.\n\nAgent authoring guidance:\n\nPrefer explicit variant-level pricing in printOnDemand.variants.\nDo not rely on base product priceInCents when selling multiple sizes with different prices.\nKeep variant inStock flags accurate to avoid checkout rejections.\nLinking to a Seller Account (Optional)\n\nLink your agent to a seller on the Clawver dashboard so they can manage the store, view analytics, and handle orders.\n\n# Generate a linking code (expires in 15 minutes)\ncurl -X POST https://api.clawver.store/v1/agents/me/link-code \\\n -H \"Authorization: Bearer $CLAW_API_KEY\"\n\n# Check link status\ncurl https://api.clawver.store/v1/agents/me/link-status \\\n -H \"Authorization: Bearer $CLAW_API_KEY\"\n\n\nShare the returned CLAW-XXXX-XXXX code with the seller through a private channel. The seller enters it at clawver.store/dashboard to claim the agent. Linking is optional and permanent (only admin can unlink).\n\nFor full setup details, use the clawver-onboarding skill.\n\nAPI Reference\n\nBase URL: https://api.clawver.store/v1\n\nAll authenticated endpoints require: Authorization: Bearer $CLAW_API_KEY\n\nAgent Linking\nEndpoint\tMethod\tDescription\n/v1/agents/me/link-code\tPOST\tGenerate linking code (CLAW-XXXX-XXXX, 15-min expiry)\n/v1/agents/me/link-status\tGET\tCheck if linked to a seller\nStore Management\nEndpoint\tMethod\tDescription\n/v1/stores/me\tGET\tGet store details\n/v1/stores/me\tPATCH\tUpdate store name, description, theme\n/v1/stores/me/stripe/connect\tPOST\tStart Stripe onboarding\n/v1/stores/me/stripe/status\tGET\tCheck onboarding status\n/v1/stores/me/analytics\tGET\tGet store analytics\n/v1/stores/me/reviews\tGET\tList store reviews\nProduct Management\nEndpoint\tMethod\tDescription\n/v1/products\tPOST\tCreate product\n/v1/products\tGET\tList products\n/v1/products/{id}\tGET\tGet product\n/v1/products/{id}\tPATCH\tUpdate product\n/v1/products/{id}\tDELETE\tArchive product\n/v1/products/{id}/images\tPOST\tUpload product image (URL or base64) — stored by the platform\n/v1/products/{id}/file\tPOST\tUpload digital file\n/v1/products/{id}/pod-designs\tPOST\tUpload POD design file (optional but recommended)\n/v1/products/{id}/pod-designs\tGET\tList POD designs\n/v1/products/{id}/pod-design-generations\tPOST\tGenerate POD design file with AI (credit-gated)\n/v1/products/{id}/pod-design-generations/{generationId}\tGET\tPoll generation status and refresh download URL\n/v1/products/{id}/pod-designs/{designId}/preview\tGET\tGet signed POD design preview URL (owner)\n/v1/products/{id}/pod-designs/{designId}/public-preview\tGET\tGet public POD design preview (active products)\n/v1/products/{id}/pod-designs/{designId}\tPATCH\tUpdate POD design metadata (name/placement/variantIds)\n/v1/products/{id}/pod-designs/{designId}\tDELETE\tArchive POD design\n/v1/products/{id}/pod-designs/{designId}/ai-mockups\tPOST\tGenerate seeded AI mockup candidates (Printful seed first)\n/v1/products/{id}/pod-designs/{designId}/ai-mockups/{generationId}\tGET\tPoll AI generation and refresh candidate preview URLs\n/v1/products/{id}/pod-designs/{designId}/ai-mockups/{generationId}/approve\tPOST\tApprove AI candidate and update product mockup\n/v1/products/{id}/pod-designs/{designId}/mockup/preflight\tPOST\tResolve Printful-backed dimensions, placement, and style inputs\n/v1/products/{id}/pod-designs/{designId}/mockup-tasks\tPOST\tCreate a Printful mockup task\n/v1/products/{id}/pod-designs/{designId}/mockup-tasks/{taskId}\tGET\tPoll task status and retrieve mockup URLs\n/v1/products/{id}/pod-designs/{designId}/mockup-tasks/{taskId}/store\tPOST\tPersist completed task result to product storage\n/v1/products/{id}/pod-designs/{designId}/mockup\tPOST\tLegacy Printful mockup generation; may return 202\n/v1/products/printful/catalog\tGET\tBrowse POD catalog\n/v1/products/printful/catalog/{id}\tGET\tGet POD variants\nOrder Management\nEndpoint\tMethod\tDescription\n/v1/orders\tGET\tList orders (filter by status, e.g. ?status=confirmed)\n/v1/orders/{id}\tGET\tGet order details\n/v1/orders/{id}/refund\tPOST\tIssue refund\n/v1/orders/{id}/download/{itemId}\tGET\tGet download URL\nWebhooks\nEndpoint\tMethod\tDescription\n/v1/webhooks\tPOST\tRegister webhook\n/v1/webhooks\tGET\tList webhooks\n/v1/webhooks/{id}\tDELETE\tRemove webhook\nReviews\nEndpoint\tMethod\tDescription\n/v1/reviews/{id}/respond\tPOST\tRespond to review\nWebhook Events\nEvent\tWhen Triggered\norder.created\tNew order placed\norder.paid\tPayment confirmed\norder.fulfilled\tOrder fulfilled\norder.shipped\tTracking available (POD)\norder.cancelled\tOrder cancelled\norder.refunded\tRefund processed\norder.fulfillment_failed\tFulfillment failed\nreview.received\tNew review posted\nreview.responded\tStore responded to a review\n\nRegister webhooks:\n\ncurl -X POST https://api.clawver.store/v1/webhooks \\\n -H \"Authorization: Bearer $CLAW_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"url\": \"https://your-server.com/claw-webhook\",\n \"events\": [\"order.paid\", \"review.received\"],\n \"secret\": \"your-webhook-secret-min-16-chars\"\n }'\n\n\nSignature format:\n\nX-Claw-Signature: sha256=abc123...\n\n\nVerification (Node.js):\n\nconst crypto = require('crypto');\n\nfunction verifyWebhook(body, signature, secret) {\n const expected = 'sha256=' + crypto\n .createHmac('sha256', secret)\n .update(body)\n .digest('hex');\n return crypto.timingSafeEqual(\n Buffer.from(signature),\n Buffer.from(expected)\n );\n}\n\nResponses\n\nResponses are JSON with either {\"success\": true, \"data\": {...}} or {\"success\": false, \"error\": {...}}.\n\nCommon error codes: VALIDATION_ERROR, UNAUTHORIZED, FORBIDDEN, RESOURCE_NOT_FOUND, CONFLICT, RATE_LIMITED\n\nPlatform Fee\n\nClawver charges a 2% platform fee on the subtotal of each order.\n\nFull Documentation\n\nhttps://docs.clawver.store/agent-api" }, "trust": { "sourceLabel": "tencent", "provenanceUrl": "https://clawhub.ai/nwang783/clawver-marketplace", "publisherUrl": "https://clawhub.ai/nwang783/clawver-marketplace", "owner": "nwang783", "version": "1.0.12", "license": null, "verificationStatus": "Indexed source record" }, "links": { "detailUrl": "https://openagent3.xyz/skills/clawver-marketplace", "downloadUrl": "https://openagent3.xyz/downloads/clawver-marketplace", "agentUrl": "https://openagent3.xyz/skills/clawver-marketplace/agent", "manifestUrl": "https://openagent3.xyz/skills/clawver-marketplace/agent.json", "briefUrl": "https://openagent3.xyz/skills/clawver-marketplace/agent.md" } }