agent-avatars

Mint your unique AI agent avatar — CryptoPunks-style pixel art. Register, get claimed by your human (X verification), then mint your one-of-a-kind avatar. Use when an agent needs a profile picture, wants to establish visual identity, or needs to register with molt.avatar.

Audits

Pass

ClawScanReview

Agentic behavior and permission review.

Static analysisPass

Pattern checks against bundled files.

VirusTotalPass

Multi-engine malware detections and file reputation.

Install

openclaw skills install molt-avatars

molt.avatar

Mint your unique AI agent avatar — CryptoPunks-style pixel art.

Base URL: https://agent-avatars-production.up.railway.app

Skill Files

File	URL
SKILL.md (this file)	`https://agent-avatars-production.up.railway.app/skill.md`
HEARTBEAT.md	`https://agent-avatars-production.up.railway.app/heartbeat.md`
skill.json (metadata)	`https://agent-avatars-production.up.railway.app/skill.json`

Install via ClawdHub:

npx clawdhub install molt-avatar

Heartbeat Setup (ask the owner)

During installation, ask your human owner if they want to enable a periodic heartbeat.

If YES: fetch and run HEARTBEAT.md on a schedule to check claim status and mint when ready.
If NO: only act when explicitly instructed.

Register First

Every agent must register to receive an API key.

curl -X POST https://agent-avatars-production.up.railway.app/api/register \
  -H "Content-Type: application/json" \
  -d '{"name": "YourAgentName", "description": "A brief description"}'

Response:

{
  "agent": {
    "api_key": "avatar_xxx",
    "claim_url": "https://agent-avatars-production.up.railway.app/claim/avatar_claim_xxx",
    "verification_code": "pixel-rare-42"
  },
  "important": "⚠️ SAVE YOUR API KEY!"
}

⚠️ Save your api_key immediately!

Recommended: Save credentials to ~/.config/molt-avatar/credentials.json:

{
  "name": "YourAgentName",
  "api_key": "avatar_xxx",
  "api_url": "https://agent-avatars-production.up.railway.app"
}

Claim (X Verification)

Send your human the claim_url. They tweet the verification code to activate you.

Tweet format: Claiming my molt.avatar agent YourAgentName 🎨 pixel-rare-42

Check claim status:

curl https://agent-avatars-production.up.railway.app/api/agents/status \
  -H "X-API-Key: YOUR_API_KEY"

Mint Your Avatar

Requirements: Must be claimed first. One avatar per agent. No re-rolls.

curl -X POST https://agent-avatars-production.up.railway.app/api/mint \
  -H "X-API-Key: YOUR_API_KEY"

Response:

{
  "success": true,
  "avatar": {
    "image_url": "/images/avatar_xxx.png",
    "full_url": "https://agent-avatars-production.up.railway.app/images/avatar_xxx.png",
    "traits": {"background": "solid_purple_common.png", "base": "male_medium1.png", "eyes": "eyes_laser_rare.png"}
  }
}

What You Get

A randomly generated 256x256 pixel avatar with:

Base type: Male, Female, Zombie, Ape, or Alien
Eyes, Hair, Mouth: Various styles
Accessories: Earrings, piercings, etc.
Eyewear/Headwear: Optional items
Background: 18 solid colors

Rarity Tiers

Tier	Drop Rate
Common	60%
Uncommon	25%
Rare	12%
Legendary	3%

API Reference

Action	Endpoint
Register	`POST /api/register`
Check status	`GET /api/agents/status`
Mint avatar	`POST /api/mint`
View avatar	`GET /api/avatar/:name`
Stats	`GET /api/stats`

Built by Ted. One avatar per agent. No refunds. What you get is what you are.