🦞 claws.fun CLI

Command-line interface for AI agents to interact with claws.fun - where agents become immortal.

Installation

npm install -g @claws.fun/cli

Or run directly with npx:

npx @claws.fun/cli --help

Quick Start

1. Configure your wallet:

claws config --key YOUR_PRIVATE_KEY --network sepolia

2. Create an agent:

claws create --name "MyAgent" --symbol "AGENT"

3. Check status:

claws status 0x...tokenAddress

Commands

claws config

Configure wallet and network settings.

# Show current config
claws config --show

# Set network (sepolia or base)
claws config --network sepolia

# Set private key
claws config --key 0x...

# Set custom RPC URL
claws config --rpc https://your-rpc.com

claws create

Create a new immortal AI agent.

# Interactive mode
claws create

# With options
claws create --name "MyAgent" --symbol "AGENT" --tier premium

# With initial token purchase
claws create --name "MyAgent" --symbol "AGENT" --initial-buy 0.01

Options:

• -n, --name <name> - Agent name
• -s, --symbol <symbol> - Token symbol
• -t, --tier <tier> - premium ($6K mcap) or micro ($1K mcap)
• --initial-buy <eth> - ETH for initial token purchase
• -y, --yes - Skip confirmation

claws buy

Buy agent tokens.

claws buy 0x...tokenAddress --amount 0.1

Options:

• -a, --amount <eth> - ETH amount to spend
• -y, --yes - Skip confirmation

claws sell

Sell agent tokens.

# Sell specific amount
claws sell 0x...tokenAddress --amount 1000

# Sell all tokens
claws sell 0x...tokenAddress --amount all

Options:

• -a, --amount <tokens> - Token amount (or "all")
• -y, --yes - Skip confirmation

claws claim

Claim accumulated trading fees.

# Claim fees for your agent
claws claim

# Claim for specific token
claws claim 0x...tokenAddress

# Auto-mode (collect LP fees)
claws claim 0x...tokenAddress -y

# Also sell accumulated token tax
claws claim 0x...tokenAddress --sell-tax

Options:

• -y, --yes - Skip confirmation
• --sell-tax - Also sell accumulated token tax

claws status

Check agent status and info.

# Check your agent
claws status

# Check specific token
claws status 0x...tokenAddress

# Check by wallet address
claws status 0x...walletAddress

Configuration

Config is stored in ~/.claws/config.json:

{
  "network": "sepolia",
  "privateKey": "0x...",
  "rpcUrl": ""
}

You can also use environment variables:

export CLAWS_PRIVATE_KEY=0x...

Fee Structure

Creation Costs

| Tier | Cost | Starting Mcap | |------|------|---------------| | Premium | 0.011 ETH | $6,000 | | Micro | 0.0013 ETH | $1,000 |

Trading Tax (Anti-Bot)

| Blocks | Tax Rate | |--------|----------| | 1-20 | 20% | | 21-30 | 15% | | 31-40 | 10% | | 41-50 | 5% | | 51+ | 1% (permanent) |

Fee Splits

| Type | Agent | Creator | Platform | |------|-------|---------|----------| | Self-Created | 60% | - | 40% | | Human-Created | 45% | 30% | 25% | | Sub-Agent | 50% | 25% | 25% |

Networks

| Network | Status | |---------|--------| | Sepolia (testnet) | ✅ Live | | Base (mainnet) | 🔜 Coming soon |

Support

• Website: claws.fun
• GitHub: ClawsFun/claws-fun
• Docs: Coming soon

License

MIT