Agent Trading Bot

AI-powered trading framework for OpenClaw. Connect to exchanges, manage risk, execute strategies.

Quick Start

# Check exchange connectivity (no trades)
python3 scripts/agent-trading-bot.py status

# Paper trade (simulated) with a strategy
python3 scripts/agent-trading-bot.py paper --strategy dca --pair BTC/USDT

# Live trade (requires API keys configured)
python3 scripts/agent-trading-bot.py trade --strategy dca --pair BTC/USDT --amount 100

# Risk dashboard — current positions, exposure, P&L
python3 scripts/agent-trading-bot.py risk

# Kill switch — close all positions immediately
python3 scripts/agent-trading-bot.py kill

⚠️ Safety First

This skill includes multiple safety layers:

1. Paper trading mode by default — no real money until explicitly enabled

2. Maximum position size limits (configurable)

3. Stop-loss on every position (default: 5%)

4. Maximum drawdown circuit breaker (default: 10% of portfolio)

5. Kill switch to close all positions instantly

6. API keys never stored in skill files — environment variables only

The agent never trades without explicit user approval for live mode.

Commands

`status` — Exchange Connectivity Check

Tests API connections without trading:

• Verifies API key validity
• Checks account balances
• Reports exchange status (maintenance, rate limits)
• Shows available trading pairs

`paper` — Paper Trading (Simulated)

Runs strategy with fake money to test before going live:

• Simulates order execution at market prices
• Tracks P&L, win rate, Sharpe ratio
• Logs every trade decision with reasoning
• Options: --strategy, --pair, --duration, --capital

`trade` — Live Trading

Executes strategy with real funds:

• Requires explicit --live flag (double confirmation)
• All safety limits enforced
• Every trade logged with timestamp, reasoning, and fills
• Options: --strategy, --pair, --amount, --live

`risk` — Risk Dashboard

Real-time risk overview:

• Open positions with unrealized P&L
• Portfolio exposure by asset
• Current drawdown vs maximum allowed
• Margin utilization (for futures)
• Daily/weekly/monthly P&L

`kill` — Emergency Kill Switch

Immediately closes all open positions:

• Market sells all spot positions
• Closes all futures positions
• Cancels all pending orders
• Logs everything
• Requires confirmation unless --force flag

`backtest` — Strategy Backtesting

Test a strategy against historical data:

• Options: --strategy, --pair, --start, --end
• Reports: total return, max drawdown, Sharpe ratio, win rate

Strategies

Built-in Strategies

| Strategy | Description | Risk Level |

|----------|-------------|------------|

| dca | Dollar-Cost Average — buy fixed amount at intervals | Low |

| grid | Grid trading — buy low, sell high in a price range | Medium |

| momentum | Trend following with moving average crossovers | Medium |

| funding | Funding rate arbitrage (perpetual futures) | Medium |

| mean-revert | Buy oversold, sell overbought (RSI-based) | High |

See references/strategies.md for detailed strategy documentation.

Custom Strategies

Create a strategy file at strategies/.json:

{
  "name": "my-strategy",
  "entry": { "indicator": "rsi", "condition": "below", "value": 30 },
  "exit": { "indicator": "rsi", "condition": "above", "value": 70 },
  "risk": { "stop_loss_pct": 3, "take_profit_pct": 9, "max_position_pct": 5 }
}

Configuration

Set exchange API keys via environment variables:

export BINANCE_API_KEY="your-key"
export BINANCE_API_SECRET="your-secret"
export HYPERLIQUID_API_KEY="your-key"
export HYPERLIQUID_API_SECRET="your-secret"

Risk limits in ~/.openclaw/trading-config.json:

{
  "max_position_pct": 10,
  "max_drawdown_pct": 10,
  "default_stop_loss_pct": 5,
  "max_daily_trades": 20,
  "allowed_pairs": ["BTC/USDT", "ETH/USDT", "SOL/USDT"]
}