Alpaca Trading Skill 是一款专为股票和加密货币交易设计的程序化交易工具，通过集成 Alpaca 官方 API，为用户提供从市场数据获取到订单执行的全套交易解决方案。该技能支持模拟交易与实盘交易双模式，既适合策略回测也支持真实交易操作，是技术型投资者的理想助手。
核心用法
该技能通过 Python CLI 脚本提供完整的交易功能矩阵。用户可实时获取股票报价（Quote）和历史 K 线数据（Bars），监控账户资金与持仓状况。交易功能涵盖市价单、限价单、止损单及止损限价单等多种订单类型，并支持盘前盘后交易时段操作。此外，技能提供实时行情 WebSocket 推送、价格预警设置、自选股管理（Watchlist）和财经新闻获取等辅助功能，满足从数据分析到交易执行的全流程需求，所有操作均可通过命令行快速完成。
显著优点
最突出的特点是其六层交易安全护栏机制：符号验证确保股票代码有效；购买力检查防止超额交易并显示最大可买数量；重复订单检测避免同方向误操作；价格偏离警告防止以不利价格成交；市场时间检查区分盘中、盘前、盘后及闭市状态；成本确认环节要求最终人工确认。这些机制显著降低了误操作风险。同时，技能使用 Alpaca 官方 SDK 保障通信安全，支持环境变量与本地配置文件灵活管理 API 密钥，且具备完善的异常处理和输入验证，不暴露敏感信息。
潜在缺点与局限性
作为 T3 级社区来源工具，其长期维护稳定性不及官方认证产品，需用户关注后续更新。功能上受限于 Alpaca API 本身的限制，如不支持高频交易场景，API 调用存在速率限制。实时数据流功能依赖网络稳定性，断线后需手动重连。价格预警数据仅存储于本地文件（~/.openclaw/data/alpaca-alerts.json），不支持跨设备同步，且缺乏移动端支持，仅适合桌面/服务器环境使用。
适合的目标群体
该技能适合具备基础金融知识的个人投资者、量化交易爱好者及希望自动化交易策略的技术用户。特别是需要同时监控多只股票、执行条件单或进行程序化策略回测的用户。由于支持模拟交易（Paper Trading），也适合金融专业学生或交易新手在无风险环境下学习市场运作。对于需要 7×24 小时自动化监控和预警的交易系统开发者，该工具提供了良好的基础框架。
使用风险
首要风险是资金安全风险，尽管有安全护栏，但使用 --force 参数会跳过所有确认环节，可能导致意外大额交易或错误下单。其次是市场流动性风险，特别是在盘前盘后时段，可能出现滑点或无法成交的情况，且此时段波动性通常更大。技术风险方面，API 密钥若未妥善保管（如硬编码在代码中）可能导致账户被盗用。此外，网络延迟或 API 服务中断可能导致交易指令未能及时执行，在快速波动的市场中可能造成损失。建议始终优先使用模拟交易环境测试策略，定期检查持仓与订单状态，并避免在闭市时段下达急需成交的订单。