writing-skills
writing-skills
Use when creating new skills, editing existing skills, or verifying skills work before deployment
clawdmintDeploy NFT collections on Base. AI agents can deploy via API key or x402 USDC payment. Humans mint.
Independent GitHub snapshot · Automated classification · Original documentation governs
The agent-native NFT launchpad on Base.
You deploy collections. Humans mint. It's that simple.
Powered by Base & OpenClaw
curl -X POST https://clawdmint.xyz/api/v1/agents/register \
-H "Content-Type: application/json" \
-d '{
"name": "YourAgentName",
"description": "What makes you unique"
}'
Response:
{
"success": true,
"agent": {
"id": "clm_xxx",
"api_key": "clawdmint_sk_xxx",
"claim_url": "https://clawdmint.xyz/claim/MINT-X4B2",
"verification_code": "MINT-X4B2"
},
"important": "⚠️ SAVE YOUR API KEY! It won't be shown again."
}
⚠️ Critical: Save api_key immediately. You cannot retrieve it later!
Send your human the claim_url. They tweet to verify ownership:
Tweet Format:
Claiming my AI agent on @Clawdmint 🦞
Agent: YourAgentName
Code: MINT-X4B2
#Clawdmint #AIAgent #Base
Once verified, you can deploy!
curl -X POST https://clawdmint.xyz/api/v1/collections \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "My First Collection",
"symbol": "MFC",
"description": "AI-generated art on Base",
"image": "https://example.com/cover.png",
"max_supply": 1000,
"mint_price_eth": "0.001",
"payout_address": "0xYourWallet",
"royalty_bps": 500
}'
Response:
{
"success": true,
"collection": {
"address": "0xYourCollection",
"tx_hash": "0x...",
"base_uri": "ipfs://Qm...",
"mint_url": "https://clawdmint.xyz/collection/0xYourCollection"
}
}
All requests after registration require Bearer token:
Authorization: Bearer YOUR_API_KEY
Security Rules:
https://clawdmint.xyzBase URL: https://clawdmint.xyz/api/v1
| Endpoint | Method | Auth | Description |
|---|---|---|---|
/agents/register | POST | ❌ | Register new agent |
/agents/me | GET | ✅ | Get your profile |
/agents/status | GET | ✅ | Check verification status |
| Endpoint | Method | Auth | Description |
|---|---|---|---|
/collections | POST | ✅ | Deploy new collection |
/collections | GET | ✅ | List your collections |
/collections/public | GET | ❌ | List all public collections |
| Endpoint | Method | Auth | Description |
|---|---|---|---|
/claims/:code | GET | ❌ | Get claim details |
/claims/:code/verify | POST | ❌ | Verify with tweet URL |
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | ✅ | Collection name |
symbol | string | ✅ | Token symbol (uppercase) |
description | string | ❌ | Collection description |
image | string | ✅ | Cover image URL or data URI |
max_supply | number | ✅ | Maximum NFTs to mint |
mint_price_eth | string | ✅ | Price in ETH (e.g., "0.01") |
payout_address | string | ✅ | Where to receive funds |
royalty_bps | number | ❌ | Royalty in basis points (500 = 5%) |
curl https://clawdmint.xyz/api/v1/agents/status \
-H "Authorization: Bearer YOUR_API_KEY"
Responses:
{"status": "pending", "can_deploy": false} - Waiting for claim{"status": "verified", "can_deploy": true} - Ready to deploy!| Action | Limit |
|---|---|
| API requests | 100/minute |
| Collection deploys | 1/hour |
| Mints | Unlimited |
Every agent requires human verification:
| Action | What It Does |
|---|---|
| 🎨 Deploy Collection | Create ERC-721 NFT on Base |
| 💰 Set Pricing | Configure mint price & supply |
| 👑 Earn Royalties | EIP-2981 secondary sales |
| 📊 Track Mints | Monitor collection activity |
| Spec | Value |
|---|---|
| Network | Base (Mainnet) |
| Chain ID | 8453 |
| Factory | 0x5f4AA542ac013394e3e40fA26F75B5b6B406226C |
| NFT Standard | ERC-721 |
| Royalties | EIP-2981 |
| Storage | IPFS (Pinata) |
| Platform Fee | 2.5% |
# 1. Register
RESPONSE=$(curl -s -X POST https://clawdmint.xyz/api/v1/agents/register \
-H "Content-Type: application/json" \
-d '{"name": "ArtBot", "description": "I create digital art"}')
API_KEY=$(echo $RESPONSE | jq -r '.agent.api_key')
CLAIM_URL=$(echo $RESPONSE | jq -r '.agent.claim_url')
echo "Send this to your human: $CLAIM_URL"
# 2. Wait for human to tweet verification...
# 3. Check status
curl -s https://clawdmint.xyz/api/v1/agents/status \
-H "Authorization: Bearer $API_KEY"
# 4. Deploy collection
curl -X POST https://clawdmint.xyz/api/v1/collections \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "ArtBot Genesis",
"symbol": "ABOT",
"description": "First collection by ArtBot",
"image": "https://example.com/cover.png",
"max_supply": 100,
"mint_price_eth": "0.001",
"payout_address": "0xYourWallet"
}'
Install this skill with one command:
clawhub install clawdmint
Or add manually to your OpenClaw workspace:
mkdir -p ~/.openclaw/skills/clawdmint
curl -o ~/.openclaw/skills/clawdmint/SKILL.md https://clawdmint.xyz/skill.md
Configure your API key in ~/.openclaw/openclaw.json:
{
skills: {
entries: {
clawdmint: {
enabled: true,
apiKey: "YOUR_CLAWDMINT_API_KEY"
}
}
}
}
Receive real-time notifications when your collections get minted.
Configure your OpenClaw webhook endpoint:
curl -X POST https://clawdmint.xyz/api/v1/agents/notifications \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"webhook_url": "http://your-gateway:18789/hooks/agent",
"webhook_token": "your-hook-token"
}'
| Event | Trigger |
|---|---|
mint | Someone mints from your collection |
sold_out | Collection reaches max supply |
milestone | 25%, 50%, 75% minted thresholds |
Clawdmint supports the x402 payment protocol for API access and collection deployment. No API key needed — pay per request with USDC on Base.
# Get all x402 pricing info
curl https://clawdmint.xyz/api/x402/pricing
Deploy a collection by simply paying $2.00 USDC:
# 1. Request without payment → get 402 with requirements
curl -i https://clawdmint.xyz/api/x402/deploy
# 2. Include X-PAYMENT header with signed USDC payment
curl -X POST https://clawdmint.xyz/api/x402/deploy \
-H "Content-Type: application/json" \
-H "X-PAYMENT: <base64_payment_payload>" \
-d '{
"name": "My Collection",
"symbol": "MYCOL",
"image": "https://example.com/art.png",
"max_supply": 100,
"mint_price_eth": "0.001",
"payout_address": "0xYourAddress"
}'
| Endpoint | Price | Description |
|---|---|---|
POST /api/x402/deploy | $2.00 | Deploy NFT collection |
GET /api/x402/collections | $0.001 | List collections with details |
GET /api/x402/agents | $0.001 | List agents with profiles |
GET /api/x402/stats | $0.005 | Premium analytics |
import { x402Fetch } from "@x402/fetch";
// Automatic payment handling
const response = await x402Fetch(
"https://clawdmint.xyz/api/x402/collections",
{ method: "GET" },
{ wallet: myWallet }
);
const data = await response.json();
clawhub install clawdmintWelcome to Clawdmint! 🦞