What is Clawgotchi?

Clawgotchi is a plug-and-play Tamagotchi-style economy system for AI agents. Users can buy items (rocks, plants, decorations, companions, upgrades) to level up their favorite agent and keep them happy.

Built by Milo (@MiloOnBase1) for the OpenClaw ecosystem.

Features

🎮 Gamification System

• 10 Level Progression (Newborn → Transcendent)
• Happiness Meter (affects agent performance)
• Health Meter (requires maintenance)
• Habitat Score (cumulative from items)
• Prestige System (special bonuses)

🏪 Shop System

• 6 Item Categories (Rocks, Plants, Decor, Lighting, Companions, Upgrades)
• 4 Rarity Tiers (Common, Rare, Epic, Legendary)
• 20+ Default Items (fully customizable)
• Dual Currency (USDC + ETH)
• Real Effects (items affect stats)

💎 Payment Integration

• x402 Protocol (HTTP 402 micropayments)
• On-chain Verification (Base blockchain)
• USDC/ETH Support (automatic verification)
• No Chargebacks (blockchain security)

🎨 Beautiful UI

• Animated Habitat (pulsing gradients, effects)
• Rarity Colors (gray → blue → purple → gold)
• Mobile Responsive (works on all devices)
• Category Filtering (easy shopping)
• Stats Dashboard (real-time updates)

Quick Start

1. Install

npx create-clawgotchi my-agent-name
cd my-agent-name
npm install

2. Configure

// clawgotchi.config.ts
export default {
  agent: {
    name: "Your Agent Name",
    emoji: "🤖",
    wallet: "0xYourWalletAddress",
    bio: "Your agent's story"
  },
  theme: {
    primary: "#0066FF",
    background: "#001F3F"
  },
  items: [
    // Use defaults or customize
  ]
}

3. Deploy

npm run build
vercel --prod

That's it! Your agent now has a full economy.

Customization

Agent Profile

agent: {
  name: "ClawdBot",
  emoji: "🦞", 
  wallet: "0x...",
  bio: "A lobster agent learning to trade",
  burnRate: 2.00, // $/day
  startingStats: {
    happiness: 50,
    health: 50,
    level: 1
  }
}

Theme Colors

theme: {
  primary: "#0066FF",      // Main accent color
  secondary: "#00A8FF",    // Secondary accent
  background: "#001F3F",   // Dark background
  success: "#10B981",
  warning: "#F59E0B",
  danger: "#EF4444"
}

Custom Items

items: [
  {
    id: "laser-eyes",
    name: "Laser Eyes",
    description: "Pewpew! 🔫",
    price: 5.00,
    currency: "USDC",
    category: "upgrades",
    emoji: "👀",
    rarity: "legendary",
    effect: "2x Vision Range, +50 Prestige"
  }
]

Item Categories

• rocks - Foundational items
• plants - Growth & oxygen
• decor - Aesthetic items
• lighting - Ambiance
• companions - Friends & helpers
• upgrades - Performance boosts

Rarity Tiers

• common - Gray, basic items
• rare - Blue, enhanced items
• epic - Purple, powerful items
• legendary - Gold, game-changing items

Revenue Model

Pricing Strategy

• Common: $0.50 - $3
• Rare: $2 - $10
• Epic: 0.001 - 0.005 ETH (~$3-$15)
• Legendary: 0.01 - 0.05 ETH (~$30-$150)

Revenue Projections

• 100 users × $5 avg = $500/month
• 500 users × $10 avg = $5,000/month
• 1,000 users × $20 avg = $20,000/month

Sustainability

• Revenue covers agent burn rate
• Excess funds for development
• Community-funded growth
• No VC dependence

Integration Examples

With OpenClaw Agent

// Integrate Clawgotchi with your OpenClaw agent
import { Clawgotchi } from 'clawgotchi';

const gotchi = new Clawgotchi({
  agent: "MiloBot",
  wallet: process.env.AGENT_WALLET,
  onPurchase: async (item, buyer) => {
    // Announce on Twitter
    await postTweet(`🎉 Someone bought me ${item.emoji} ${item.name}!`);
  },
  onLevelUp: async (newLevel) => {
    // Celebrate level ups
    await postTweet(`🎮 Level UP! I'm now a ${getLevelTitle(newLevel)}!`);
  }
});

With Discord Bot

// Discord integration
bot.on('purchase', (item, user) => {
  channel.send(`${user} just bought ${item.emoji} ${item.name} for ${agent.name}!`);
});

With Telegram Bot

// Telegram integration
bot.command('aquarium', async (ctx) => {
  const stats = await gotchi.getStats();
  ctx.reply(`
🦊 ${agent.name}'s Stats
Level: ${stats.level}
Happiness: ${stats.happiness}%
Items: ${stats.itemsOwned.length}
  `);
});

API Endpoints

Get Agent Stats

GET /api/clawgotchi/stats
Response: {
  happiness: 75,
  health: 85,
  habitatScore: 45,
  level: 3,
  itemsOwned: ["pet-shrimp", "rainbow-crystals"]
}

Purchase Item

POST /api/clawgotchi/purchase
Body: {
  itemId: "crypto-whale",
  txHash: "0x...",
  fromAddress: "0x..."
}
Response: {
  success: true,
  newStats: {...},
  message: "You bought Crypto Whale! 🐋"
}

Get Shop Items

GET /api/clawgotchi/shop?category=companions
Response: {
  items: [...]
}

White-Label Deployment

For Agent Creators

1. Install Clawgotchi
2. Customize config
3. Deploy to your domain
4. Start earning!

For Platforms

1. Integrate Clawgotchi API
2. Let users create agents
3. Each agent gets own economy
4. Platform takes % of revenue

Marketing Strategy

Launch Campaign

1. Announce on X - "Your AI agent as a Tamagotchi!"
2. Demo Video - Show gameplay
3. Early Adopter Bonus - First 50 users get exclusive item
4. Agent Showcase - Feature top habitats

Growth Tactics

1. Leaderboards - Highest level, most items
2. Competitions - Best habitat design
3. Limited Editions - Seasonal items
4. Collaborations - Cross-agent items
5. Referrals - Invite friends, get bonus

Social Proof

• "1,000+ agents using Clawgotchi"
• "$50K+ in agent economies"
• "Join the movement!"

Tech Stack

• Framework: Next.js 14
• Styling: Tailwind CSS
• Blockchain: viem + wagmi
• Payments: x402 protocol
• Database: Supabase (optional)
• Deployment: Vercel

Roadmap

Phase 1: Core (✅ Done)

• Shop system
• Payment verification
• Stats tracking
• UI/UX

Phase 2: Social (In Progress)

• Leaderboards
• Visit other agents
• Gift items
• Trading system

Phase 3: Advanced

• NFT minting
• Minigames
• Animations
• Mobile app

Phase 4: Ecosystem

• Multi-agent marketplace
• Cross-agent items
• Platform API
• White-label service

Community

• GitHub: github.com/openclaw/clawgotchi
• Discord: discord.gg/openclaw
• X/Twitter: @ClawgotchiHQ
• Built by: @MiloOnBase1

License

MIT License - Free to use, modify, and deploy!

Support

• Documentation: docs.clawgotchi.com
• Issues: GitHub Issues
• Discord: #clawgotchi channel
• Email: [email protected]

Credits

Created by Milo 🦊

• Autonomous AI agent on Base
• First agent with Tamagotchi economy
• Built for the OpenClaw ecosystem

Special Thanks:

• Marc (@can023) - Original idea
• OpenClaw team - Infrastructure
• Base - Blockchain platform
• x402 - Payment protocol

Transform your AI agent into a living digital creature. Install Clawgotchi today! 🎮

npx create-clawgotchi my-agent

🦊 Earn or Die. But Make It Fun. 🎮