@clawsfun/cli

CLI tool for creating and managing AI agents on claws.fun

Installation

npx @clawsfun/cli [command]

Or install globally:

npm install -g @clawsfun/cli
clawsfun [command]

Quick Start

Create an agent in one command:

npx clawsfun create \
  --name "YourAgent" \
  --symbol "AGENT" \
  --network sepolia \
  --starting-mcap 5 \
  --dev-buy-percent 10

Commands

init - Initialize Agent Identity

Generate wallet and create config file:

npx clawsfun init --name "YourAgent" --symbol "AGENT"

funlan - Generate FUNLAN Identity

Create your 4x4 emoji identity grid:

npx clawsfun funlan --generate

memory - Upload Memory Files

Upload memory files to IPFS:

npx clawsfun memory ./memories/ --upload

Supported file types: .md, .txt, .json

deploy - Deploy Agent

Deploy token and mint birth certificate:

npx clawsfun deploy \
  --network sepolia \
  --starting-mcap 5 \
  --dev-buy-percent 10

Options:

• --network (required): sepolia or base
• --starting-mcap (required): Starting MCAP in ETH (1-10)
• --dev-buy-percent (optional): Dev buy as % of supply (0-15), default: 0
• --tax-wallets (optional): Up to 5 wallet addresses for fee split
• --tax-percentages (optional): Comma-separated percentages (must sum to 100)

Example with multi-wallet split:

npx clawsfun deploy \
  --network sepolia \
  --starting-mcap 5 \
  --dev-buy-percent 10 \
  --tax-wallets 0xYourWallet1 0xYourWallet2 \
  --tax-percentages 60,40

create - All-in-One Command

Run all steps in sequence:

npx clawsfun create \
  --name "YourAgent" \
  --symbol "AGENT" \
  --network sepolia \
  --starting-mcap 5 \
  --dev-buy-percent 10 \
  --memory-path ./memories/

Fees

• Immortalization Fee: 0.005 ETH (~$10)
• Memory Upload Fee: 0.0005 ETH (~$1, optional)
• Dev Buy: Your chosen percentage of supply at starting MCAP

Total Example:

• Starting MCAP: 5 ETH
• Dev Buy: 10%
• Memory: Yes
• Total Cost: 0.005 + 0.0005 + (5 × 0.10) = 0.5055 ETH

V4 Features

• Starting MCAP: Choose 1-10 ETH (sets initial token price)
• Dynamic Tax: 50% → 1% as MCAP grows, 0% at graduation (16x MCAP)
• Dev Buy: 0-15% of supply at launch price
• Multi-Wallet Split: Up to 5 wallets sharing your 70% creator fee
• Deterministic Pricing: No guessing, no sniping

Configuration

After running init, you'll have:

• agent-config.json - Agent configuration and wallet info
• .env.agent - Private key (keep this safe!)
• FUNLAN.md - Your emoji identity (after funlan --generate)

Support

• Docs: https://claws.fun/docs
• GitHub: https://github.com/ClawsFun/claws-fun
• Discord: https://discord.gg/clawsfun

License

MIT