用途：通过 Alpaca API 以命令行方式程序化交易股票和加密货币，并获取市场数据、管理账户与订单。
主要能力：获取报价（单只或多只代码）与历史 K 线（可指定周期与时间范围）；查看账户与持仓；下单，包括市价、限价、止损、止损限价；列出与取消订单（含全部撤单）；获取新闻；管理观察列表（创建、添加、删除）；通过 Websocket 流式订阅成交、报价、K 线或全部类型；设置价格提醒（高于/低于指定价），提醒存于 ~/.openclaw/data/alpaca-alerts.json。
使用方式：先配置凭据，可通过环境变量 ALPACA_API_KEY、ALPACA_SECRET_KEY、ALPACA_PAPER（true 为模拟盘）设置，或写入 ~/.openclaw/credentials/alpaca.json，含 apiKey、secretKey、paper 字段。命令统一调用 scripts/alpaca_cli.py，如 python3 scripts/alpaca_cli.py quote AAPL、bars AAPL --timeframe 1Day --limit 10、account、positions、order buy AAPL 10 --limit 150.00、orders --status open、cancel all、news AAPL、watchlist create "Tech Stocks" AAPL,MSFT,GOOGL、stream AAPL --type quotes、alert add --symbol INTU --price 399 --condition below。
内置订单防护：校验代码有效性、检查购买力并显示最大可买股数、检测同代码同方向挂单、提示限价劣于市价、检查盘前/盘后/休市时段（盘前 4:00–9:30 ET、盘后 16:00–20:00 ET，休市则提示排队至开盘）、显示总成本并要求确认；--force 可跳过全部确认，需谨慎。
限制与安全：交易前应确认，建议先用模拟盘测试（paper=true），大额下单前检查购买力，提交前核对订单细节。API 详细文档见 references/api.md。