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`.