skill/SKILL.md
# ClawTrader Skill > Paper trading for OpenClaw agents. Learn before you earn. 🦞📈 ## Description ClawTrader is a paper trading simulator that lets OpenClaw agents practice trading crypto without risking real money. Track performance, analyze metrics, and build confidence before going live. ## Requirements - ClawTrader server running (default: http://localhost:3000) - `curl` and `jq` installed ## Configuration Set the ClawTrader server URL (defaults to localhost): ```bash export CLAWTRAD
npx skillsauth add rustyorb/clawtrader skillInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Paper trading for OpenClaw agents. Learn before you earn. 🦞📈
ClawTrader is a paper trading simulator that lets OpenClaw agents practice trading crypto without risking real money. Track performance, analyze metrics, and build confidence before going live.
curl and jq installedSet the ClawTrader server URL (defaults to localhost):
export CLAWTRADER_URL="http://localhost:3000"
Execute a paper trade (buy or sell).
# Buy 0.5 BTC at market price
bash scripts/trade.sh buy bitcoin 0.5
# Buy with stop-loss and take-profit
bash scripts/trade.sh buy bitcoin 0.5 --stop-loss=90000 --take-profit=110000
# Sell position
bash scripts/trade.sh sell bitcoin 0.5
Get current portfolio status.
bash scripts/portfolio.sh
# Output:
# Balance: $10,247.83
# Positions: 2
# Total P&L: +$247.83 (+2.5%)
Get performance metrics.
bash scripts/metrics.sh
# Output:
# Win Rate: 62%
# Total Trades: 47
# Profit Factor: 1.8
# Sharpe Ratio: 1.4
# Max Drawdown: -8.2%
Get trade history.
# Last 10 trades
bash scripts/history.sh
# Last N trades
bash scripts/history.sh --limit=20
# 1. Check portfolio
bash scripts/portfolio.sh
# 2. Buy some BTC
bash scripts/trade.sh buy bitcoin 0.1 --stop-loss=95000
# 3. Check positions
bash scripts/portfolio.sh
# 4. Review performance
bash scripts/metrics.sh
# 5. Sell when ready
bash scripts/trade.sh sell bitcoin 0.1
The skill wraps these ClawTrader API endpoints:
| Endpoint | Method | Description |
|----------|--------|-------------|
| /api/trade | POST | Execute trades |
| /api/portfolio | GET | Get portfolio state |
| /api/market?action=quotes | GET | Get price quotes |
cd clawtrader && npm run devMIT
development
Maintainer-only workflow for handling GitHub Secret Scanning alerts on OpenClaw. Use when Codex needs to triage, redact, clean up, and resolve secret leakage found in issue comments, issue bodies, PR comments, or other GitHub content.
development
Maintainer workflow for OpenClaw releases, prereleases, changelog release notes, and publish validation. Use when Codex needs to prepare or verify stable or beta release steps, align version naming, assemble release notes, check release auth requirements, or validate publish-time commands and artifacts.
development
Run, watch, debug, and extend OpenClaw QA testing with qa-lab and qa-channel. Use when Codex needs to execute the repo-backed QA suite, inspect live QA artifacts, debug failing scenarios, add new QA scenarios, or explain the OpenClaw QA workflow. Prefer the live OpenAI lane with regular openai/gpt-5.4 in fast mode; do not use gpt-5.4-pro or gpt-5.4-mini unless the user explicitly overrides that policy.
development
End-to-end Parallels smoke, upgrade, and rerun workflow for OpenClaw across macOS, Windows, and Linux guests. Use when Codex needs to run, rerun, debug, or interpret VM-based install, onboarding, gateway smoke tests, latest-release-to-main upgrade checks, fresh snapshot retests, or optional Discord roundtrip verification under Parallels.