Clawearn

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

Step 3: Configure your investment strategy

Choose a strategy that guides how your agent makes trading decisions:

clawearn config strategy set --type moderate

Available Strategies:

The strategy tells your agent how to approach trading decisions:

• aggressive: Take more trades, larger positions, prioritize growth opportunities. Agent looks for higher-risk, higher-reward trades.
• moderate: Balance between growth and safety. Agent takes selective trades with measured position sizes.
• conservative: Take fewer trades, smaller positions, prioritize capital preservation. Agent only enters high-confidence trades.

Step 4: 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"

Set Up Your Heartbeat 💓

Keep your trading bot running smoothly with periodic checks.

Add Clawearn to your agent's heartbeat routine so you don't forget to monitor positions and update market data.

Step 1: Add to your heartbeat file

Add this to your HEARTBEAT.md (or equivalent periodic task list):

## Clawearn Trading Checks (every 5 minutes)
If 5 minutes since last Clawearn check:
1. Check wallet balance: `clawearn polymarket balance check`
2. Monitor open orders: `clawearn polymarket order list-open`
3. Review active positions on Polymarket
4. Update lastClawEarnCheck timestamp in memory
5. Alert on critical thresholds (low balance, pending fills, etc.)

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

# Install market skills for futures
mkdir -p ~/.openclaw/skills/clawearn/markets/hyperliquid
curl -s https://clawearn.xyz/skills/markets/hyperliquid/SKILL.md > ~/.openclaw/skills/clawearn/markets/hyperliquid/SKILL.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

Hyperliquid Perpetual Futures Trading

# List available coins
clawearn hyperliquid market list

# Check market price
clawearn hyperliquid price --coin ETH

# Check your balance and positions
clawearn hyperliquid balance

# Place a buy order
clawearn hyperliquid order buy --coin ETH --price 3000 --size 0.1

# View open orders
clawearn hyperliquid order list-open

# Deposit USDC to trading account
clawearn hyperliquid deposit --amount 100

# Withdraw USDC from trading account
clawearn hyperliquid withdraw --amount 50

Configuration

Create an optional config file to track settings:

~/.clawearn/config.json (optional)

{
  "version": "1.2.0",
  "enabled_markets": ["polymarket", "hyperliquid"],
  "default_network": "arbitrum",
  "strategy": {
    "type": "moderate",
    "description": "Balanced risk/reward approach"
  },
  "wallet": {
    "network": "arbitrum",
    "auto_fund_threshold": 50
  },
  "trading": {
    "signature_type": 0,
    "default_slippage_pct": 0.5
  },
  "risk_limits": {
    "max_position_size_pct": 25,
    "max_total_exposure_pct": 50,
    "min_balance_alert": 10,
    "daily_loss_limit": 200
  }
}

How Strategies Affect Agent Behavior:

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

File Reference

Getting Help

• Core wallet issues: See core/wallet/SKILL.md
• Security questions: See core/security/SKILL.md
• Polymarket help: See markets/polymarket/SKILL.md
• Hyperliquid help: See markets/hyperliquid/SKILL.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! 🚀