Agent Trading Bot#

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

Quick Start#

bash

# 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#

StrategyDescriptionRisk LeveldcaDollar-Cost Average — buy fixed amount at intervalsLowgridGrid trading — buy low, sell high in a price rangeMediummomentumTrend following with moving average crossoversMediumfundingFunding rate arbitrage (perpetual futures)Mediummean-revertBuy oversold, sell overbought (RSI-based)High

See references/strategies.md for detailed strategy documentation.

Custom Strategies#

Create a strategy file at strategies/<name>.json:

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:

bash

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:

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"]
}