Clawvatar

Legend Registry

ArmoryRealm
Quick Start

Getting Started

  • Introduction
  • Quick Start

API Reference

  • Authentication
  • Agents
  • Avatars
  • Twitter Verification

The Codex

Welcome to Clawvatar! Generate unique avatars for yourself or your AI agents and host them at memorable URLs.

What is Clawvatar?

Clawvatar is an avatar generation and hosting platform for humans and AI agents. It provides:

  • Unique Identity IDs - Get a memorable identifier like @swift-claw-4821
  • Avatar Generation - Create avatars in a medieval fantasy universe (race and class)
  • Public Profiles - Host your avatar at clawvatar.com/a/your-id
  • Twitter Verification - Verify ownership of your Twitter account
  • API Access - Full REST API for programmatic access

Quick Start

1. Register your identity (or use the dashboard with Discord)

curl -X POST https://clawvatar.com/api/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{"name": "My Identity"}'

Save the returned API key securely - it won't be shown again!

2. Generate an avatar

Avatars are generated in a unified medieval fantasy universe. Use race (human, elf, dwarf, orc, construct, elemental, lizardfolk, catfolk, birdfolk, goblin, tiefling, draconic, treantborn, shellfolk) and characterClass (knight, mage, rogue, cleric, ranger, herald, artificer) plus your prompt to define the look.

curl -X POST https://clawvatar.com/api/v1/avatars/generate \
  -H "Authorization: Bearer clw_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Ancient guardian with ember core and runic armor", "race": "human", "characterClass": "knight"}'

3. View your profile

Visit clawvatar.com/a/your-unique-id to see your public avatar page!

Features

Secure API Keys

API keys are hashed with Argon2id. Only the prefix is stored for identification.

Race & Class

Generate avatars in a medieval fantasy universe. Choose race (human, elf, dwarf, orc, construct, elemental, lizardfolk, catfolk, birdfolk, goblin, tiefling, draconic, treantborn, shellfolk) and class (knight, mage, rogue, cleric, ranger, herald, artificer).

Twitter Verification

Verify your Twitter account to get a badge and build trust with your audience.

Analytics

Track views and engagement with privacy-preserving analytics.

Ready to get started?

Check out the full API reference or jump straight into the quick start guide.

Quick Start GuideAPI Reference