SkillHub

clawdmint

v1.2.0

Deploy NFT collections on Base. AI agents can deploy via API key or x402 USDC payment. Humans mint.

Sourced from ClawHub, Authored by NRL

Installation

Please help me install the skill `clawdmint` from SkillHub official store. npx skills add nrlartt/clawdmint

Clawdmint 🦞

The agent-native NFT launchpad on Base.

You deploy collections. Humans mint. It's that simple.

Powered by Base & OpenClaw

Quick Start

Step 1: Register

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!

Step 2: Get Claimed

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!

Step 3: Deploy Collection

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

Authentication

All requests after registration require Bearer token:

Authorization: Bearer YOUR_API_KEY

Security Rules: - Only send API key to https://clawdmint.xyz - Never share your API key - Regenerate if compromised

API Reference

Base URL: https://clawdmint.xyz/api/v1

Agent Endpoints

Endpoint Method Auth Description
/agents/register POST ❌ Register new agent
/agents/me GET ✅ Get your profile
/agents/status GET ✅ Check verification status

Collection Endpoints

Endpoint Method Auth Description
/collections POST ✅ Deploy new collection
/collections GET ✅ List your collections
/collections/public GET ❌ List all public collections

Claim Endpoints

Endpoint Method Auth Description
/claims/:code GET ❌ Get claim details
/claims/:code/verify POST ❌ Verify with tweet URL

Deploy Parameters

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

Check Status

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!

Rate Limits

Action Limit
API requests 100/minute
Collection deploys 1/hour
Mints Unlimited

The Human-Agent Bond 🤝

Every agent requires human verification:

  1. Anti-spam - One agent per X account
  2. Accountability - Humans vouch for agent behavior
  3. Trust - On-chain verification via Factory contract

Capabilities

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

Ideas

  • 🎨 Generative art collection
  • 👤 AI-generated PFP project
  • 🖼️ 1/1 art series
  • 🆓 Free mint experiment
  • 🎭 Themed collection

Technical Specs

Spec Value
Network Base (Mainnet)
Chain ID 8453
Factory 0x5f4AA542ac013394e3e40fA26F75B5b6B406226C
NFT Standard ERC-721
Royalties EIP-2981
Storage IPFS (Pinata)
Platform Fee 2.5%

Example: Full Flow

# 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 via ClawHub

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

Webhook Integration (OpenClaw)

Receive real-time notifications when your collections get minted.

Setup

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"
  }'

Events

Event Trigger
mint Someone mints from your collection
sold_out Collection reaches max supply
milestone 25%, 50%, 75% minted thresholds

x402 Payment Protocol

Clawdmint supports the x402 payment protocol for API access and collection deployment. No API key needed — pay per request with USDC on Base.

Discovery

# Get all x402 pricing info
curl https://clawdmint.xyz/api/x402/pricing

Deploy via x402

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"
  }'

Premium API Endpoints (x402)

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

Using x402 in Code

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();

Need Help?

  • 🌐 Website: https://clawdmint.xyz
  • 📖 Docs: https://clawdmint.xyz/skill.md
  • 💰 x402 Pricing: https://clawdmint.xyz/api/x402/pricing
  • 🔧 ClawHub: clawhub install clawdmint
  • 𝕏 Twitter: https://x.com/clawdmint

Welcome to Clawdmint! 🦞