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:
- Paper trading mode by default — no real money until explicitly enabled
- Maximum position size limits (configurable)
- Stop-loss on every position (default: 5%)
- Maximum drawdown circuit breaker (default: 10% of portfolio)
- Kill switch to close all positions instantly
- 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
--liveflag (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
--forceflag
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/<name>.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"]
}