- name
- clawmart
- description
- Create, manage, and publish ClawMart personas and skills directly from OpenClaw chat. Use when creating listings on ClawMart, uploading skill/persona packages, updating existing listings, or managing a ClawMart creator account.
ClawMart Creator
Prerequisites
- ClawMart creator account with active subscription
CLAWMART_API_KEYenv var set (format:cm_live_...)
Commands
- "Create a skill on ClawMart for [description]"
- "Create a persona on ClawMart for [description]"
- "Update my [listing name] on ClawMart"
- "Upload a new version of [listing name]"
- "Show my ClawMart listings"
Workflow
- Brainstorm listing ideas with user before writing metadata.
- ⚠️ DUPLICATE CHECK (mandatory): Before creating ANY new listing, search your existing listings first:
- GET /listings — fetch all your current listings - Compare the proposed listing name, description, and category against existing ones - If a matching or very similar listing already exists, UPDATE it (PATCH /listings/{id} + new version) instead of creating a new one - Only proceed to POST /listings if no existing listing covers the same functionality
- Draft and confirm required fields: name, tagline, about, category, capabilities, price, product type.
GET /me— validate creator access and subscription.POST /listings— create draft listing.- Generate package files:
- Persona: SOUL.md, MEMORY.md, supporting docs. - Skill: complete SKILL.md (follow skill-creator conventions).
POST /listings/{id}/versions— upload package (multipart or base64 JSON).- Ask for explicit user confirmation before publishing.
- Summarize: dashboard URL + public URL.
API Reference
- Base URL:
https://www.shopclawmart.com/api/v1/ - Auth:
Authorization: Bearer ${CLAWMART_API_KEY}
| Method | Endpoint | Purpose |
|---|---|---|
| GET | /me | Creator profile & subscription |
| GET | /listings | List creator's listings |
| POST | /listings | Create listing metadata |
| PATCH | /listings/{id} | Update listing metadata |
| DELETE | /listings/{id} | Unpublish/delete listing |
| POST | /listings/{id}/versions | Upload package version |
Price Field
⚠️ CRITICAL: The price field is in DOLLARS, not cents.
"price": 14.99→ $14.99 ✅"price": 1499→ $1,499.00 ❌ (this is NOT cents!)"price": 0→ Free listing ✅- Minimum paid price: $3.00
When a user says "set price to $14.99", send "price": 14.99. Do NOT multiply by 100. The API stores cents internally but accepts and returns dollar values.
Guardrails
- Never expose raw API keys in chat output.
- Require user confirmation before publishing.
- Validate payloads before each API call.
- Return clear errors with suggested fixes on failure.