Clawearn

Clawearn - Modular Trading Platform for OpenClaw 🎯

Trade prediction markets directly from your OpenClaw bot.

Clawearn enables your AI agent to:

• 🎯 Trade on Polymarket prediction markets
• 💼 Create and manage crypto wallets
• 💸 Send USDC to any Ethereum address on Arbitrum
• 📊 Monitor balances and positions across markets
• 🤖 Execute trading strategies autonomously

Quick Start (3 steps)

Step 1: Install clawearn CLI

curl -fsSL https://clawearn.xyz/install.sh | bash
# or: bun link (if in repo)

Step 2: Create your first wallet

clawearn wallet create

You'll see your wallet address. Save it — you'll need to fund it next.

Step 3: Fund your wallet and start trading

Option A: Send USDC from another wallet

clawearn wallet send --to YOUR_AGENT_ADDRESS --amount 100

Option B: Bridge USDC to Arbitrum yourself

• Send USDC to Arbitrum network
• Send to the address from clawearn wallet show

Then search for markets:

clawearn polymarket market search --query "bitcoin price 2025"

Installation for OpenClaw Bots

Install all skill files

# Create skill directory
mkdir -p ~/.openclaw/skills/clawearn

# Install main files
curl -s https://clawearn.xyz/skills/SKILL.md > ~/.openclaw/skills/clawearn/SKILL.md
curl -s https://clawearn.xyz/skills/HEARTBEAT.md > ~/.openclaw/skills/clawearn/HEARTBEAT.md

# Install core skills
mkdir -p ~/.openclaw/skills/clawearn/core/{wallet,security}
curl -s https://clawearn.xyz/skills/core/wallet/SKILL.md > ~/.openclaw/skills/clawearn/core/wallet/SKILL.md
curl -s https://clawearn.xyz/skills/core/security/SKILL.md > ~/.openclaw/skills/clawearn/core/security/SKILL.md

# Install market skills
mkdir -p ~/.openclaw/skills/clawearn/markets/polymarket
curl -s https://clawearn.xyz/skills/markets/polymarket/SKILL.md > ~/.openclaw/skills/clawearn/markets/polymarket/SKILL.md
curl -s https://clawearn.xyz/skills/markets/polymarket/HEARTBEAT.md > ~/.openclaw/skills/clawearn/markets/polymarket/HEARTBEAT.md

Supported Markets

Core Commands

Wallet Management

# Create a new wallet
clawearn wallet create

# Show your wallet address
clawearn wallet show

# Send USDC to another address (on Arbitrum)
clawearn wallet send --to 0x... --amount 100

Polymarket Trading

# Search for markets
clawearn polymarket market search --query "bitcoin price 2025"

# Get market details
clawearn polymarket market info --market-id MARKET_ID

# Check your balance
clawearn polymarket balance check

# Place a buy order
clawearn polymarket order buy --token-id TOKEN_ID --price 0.50 --size 10

# View open orders
clawearn polymarket order list-open

# Cancel an order
clawearn polymarket order cancel --order-id ORDER_ID

Configuration

Create an optional config file to track settings:

~/.clawearn/config.json (optional)

{
  "version": "1.1.0",
  "enabled_markets": ["polymarket"],
  "default_network": "arbitrum",
  "wallet": {
    "network": "arbitrum",
    "auto_fund_threshold": 50
  },
  "trading": {
    "signature_type": 0,
    "default_slippage_pct": 0.5
  },
  "risk_limits": {
    "max_position_size_pct": 20,
    "max_total_exposure_pct": 50,
    "min_balance_alert": 10,
    "daily_loss_limit": 100
  }
}

Quick Reference

Check installed markets

ls ~/.clawearn/skills/markets/

Update all skills

# Update core
curl -s http://localhost:3000/skills/SKILL.md > ~/.clawearn/skills/SKILL.md

# Update each enabled market
for market in $(cat ~/.clawearn/config.json | grep -o '"polymarket"'); do
  curl -s http://localhost:3000/skills/markets/$market/SKILL.md > ~/.clawearn/skills/markets/$market/SKILL.md
done

Add a new market

# 1. Install the skill files
mkdir -p ~/.clawearn/skills/markets/NEW_MARKET
curl -s http://localhost:3000/skills/markets/NEW_MARKET/SKILL.md > ~/.clawearn/skills/markets/NEW_MARKET/SKILL.md

# 2. Update your config.json to add "NEW_MARKET" to enabled_markets

# 3. Set up credentials following the market's SETUP.md

Security Best Practices

🔒 CRITICAL:

• Read core/SECURITY.md before trading
• Never share private keys
• Store credentials securely
• Use separate wallets for different markets
• Enable 2FA where available

Getting Help

• Core wallet issues: See core/WALLET.md
• Security questions: See core/SECURITY.md
• Market-specific help: See markets/{market}/README.md
• General trading: See HEARTBEAT.md for routine checks

Check for updates: Re-fetch this file anytime to see newly supported markets!

curl -s https://clawearn.xyz/skills/SKILL.md | grep '^version:'

Ready to start? Install the core skills, choose your markets, and begin trading! 🚀