模拟交易

基于SQLite的模拟交易系统，具有不可变事件日志。

资产标识：

• - symbol 是交易/快照命令的必填项。
• mint 是snapshot和open命令的必填项（--mint
  ）。
• 如果多个持仓共享同一个symbol，请在close/set-levels命令中传递--mint参数以定位正确的持仓。
• 对于DEX上的ETH/BTC，使用包装代币合约地址（WETH、WBTC/cbBTC）作为mint。

使用场景

当用户希望进行以下操作时使用此技能：

• - 在实盘前进行模拟交易测试
• 跟踪入场/出场/止损/止盈记录
• 计算已实现和未实现盈亏
• 记录交易思路日志并进行定期复盘

数据库

默认数据库路径：

bash
~/.openclaw/paper-trading.db

可通过--db 参数覆盖默认路径。

命令

使用脚本：

bash
node --experimental-strip-types {baseDir}/scripts/paper_trading.ts --help

环境说明：

• - SQLite无需npm依赖（使用node:sqlite）。
• 当前版本的Node可能会打印SQLite的ExperimentalWarning；这是预期行为。

1) 初始化账户

bash
node --experimental-strip-types {baseDir}/scripts/paper_trading.ts init \
--account main \
--name 主模拟账户 \
--base-currency USD \
--starting-balance 10000

2) 记录市场快照（用于未实现盈亏）

bash
node --experimental-strip-types {baseDir}/scripts/paper_trading.ts snapshot \
--symbol BTC \
--mint 6p6xgHyF7AeE6TZk8x9mNQd2r2hH7r4mYJ8t6x6hYfSR \
--price 62000 \
--source dexscreener

3) 开仓

bash
node --experimental-strip-types {baseDir}/scripts/paper_trading.ts open \
--account main \
--symbol BTC \
--mint 6p6xgHyF7AeE6TZk8x9mNQd2r2hH7r4mYJ8t6x6hYfSR \
--side LONG \
--qty 0.1 \
--price 62000 \
--fee 4 \
--stop-price 60500 \
--take-price 65000 \
--max-risk-pct 1.5 \
--note 突破+成交量确认

4) 更新止损/止盈

bash
node --experimental-strip-types {baseDir}/scripts/paper_trading.ts set-levels \
--account main \
--symbol BTC \
--mint 6p6xgHyF7AeE6TZk8x9mNQd2r2hH7r4mYJ8t6x6hYfSR \
--side LONG \
--stop-price 61200 \
--take-price 66000 \
--note 上移止损以降低下行风险

5) 平仓

bash
node --experimental-strip-types {baseDir}/scripts/paper_trading.ts close \
--account main \
--symbol BTC \
--mint 6p6xgHyF7AeE6TZk8x9mNQd2r2hH7r4mYJ8t6x6hYfSR \
--side LONG \
--qty 0.05 \
--price 63500 \
--fee 3 \
--note 部分止盈

6) 交易日志

bash
node --experimental-strip-types {baseDir}/scripts/paper_trading.ts note \
--account main \
--symbol BTC \
--side LONG \
--note 若日线收盘低于61k则失效 \
--tags thesis risk macro

7) 投资组合状态

bash
node --experimental-strip-types {baseDir}/scripts/paper_trading.ts status --account main
node --experimental-strip-types {baseDir}/scripts/paper_trading.ts status --account main --format json --pretty

8) 周度复盘

bash
node --experimental-strip-types {baseDir}/scripts/paper_trading.ts review --account main
node --experimental-strip-types {baseDir}/scripts/paper_trading.ts review --account main --format json --pretty

工作流程

1. 1. 保持持有仓位symbol的快照更新，始终使用--mint和--source dexscreener参数。
2. 仅在有明确止损和风险上限（--max-risk-pct）时开仓。
3. 将每次变更记录为事件，不编辑旧事件。
4. 每次交易后运行status命令，每周结束时运行review命令。

说明

• - 事件在SQLite中仅追加（events表）。
• 盈亏通过重放事件重新计算。
• status命令使用每个symbol + mint对的最新快照计算未实现盈亏。

验证

运行完整的模拟交易测试套件：

bash
node --test {baseDir}/tests/paper_trading.test.mjs