paper-trading

What This Skill Does

The paper-trading skill provides a high-fidelity environment for simulating crypto asset trading directly within OpenClaw. It utilizes a local SQLite database to maintain immutable records of all your trades, allowing for granular tracking of positions, stop-loss triggers, and take-profit targets without risking actual capital. The system supports full-cycle management including account initialization, trade execution (open/close), portfolio snapshots for PnL calculation, and a built-in journaling system to track your trading thesis and macro risk notes. Designed for developers and traders, it integrates seamlessly with node-based execution environments, offering both raw CLI feedback and JSON-formatted output for complex data analysis workflows.

Installation

To install this skill, use the ClawHub CLI command: clawhub install openclaw/skills/skills/brs999/paper-trader. Ensure your environment has Node.js installed, as the tool leverages the native node:sqlite module for efficient, zero-dependency database interactions. Once installed, initialize your trading account using the init command to set your base currency and starting balance.

Use Cases

This skill is ideal for:

1. Strategy Backtesting: Validate your technical analysis entries and exits against simulated market conditions.
2. Risk Management Training: Practice position sizing and stop-loss placement using your specific risk parameters (e.g., max-risk-pct).
3. Trading Journaling: Maintain a clear record of the 'why' behind every trade by attaching thesis notes and tags (macro, risk, technical) directly to your position events.
4. Portfolio Monitoring: Generate periodic performance reports and check your current unrealized PnL via status snapshots.

Example Prompts

1. "I'm going long on 0.5 BTC at 64,000. Open a paper trade position for me with a stop loss at 62,000 and a take profit at 70,000. Use the WBTC mint address."
2. "Show me my current portfolio status for the main account in a clean JSON format so I can analyze my total PnL."
3. "Log a thesis note for my current long BTC position: 'Market structure shifted bullish after the breakout, keeping the stop firm at 63,500.'"

Tips & Limitations

• Mint Addresses: Always verify the correct wrapped token address (e.g., WBTC or WETH) when opening or closing positions, as the system treats these as unique identifiers for asset reconciliation.
• Experimental Warnings: The tool uses Node's experimental SQLite module; you may see a warning in the console, which is safe to ignore.
• Persistence: By default, the database lives in ~/.openclaw/paper-trading.db. You can manage multiple trading strategies by pointing to different database files using the --db flag.