tools/README.md

Tools (Architecture Only)

This directory defines the tool surface expected by openclaw.json. Implementations are intentionally left as stubs for now.

Expected modules:

• tools/alpaca_paper.py
  • submit_order(signal)
  • list_positions()
  • Safety: refuse non-paper base URL
• tools/backtesting_runner.py
  • load_price_data_from_yfinance(...)
  • load_price_data_from_csv_text(...)
  • run_backtest(...)
  • Engines: backtesting.py, backtrader
• tools/hf_storage.py
  • append_trade(record)
  • append_report(record)
  • Storage target: HF dataset repo
• tools/market_data.py
  • get_snapshot(symbols)
  • Optional: Alpaca data or external provider

All tools should accept config via environment variables listed in openclaw.json.