核心功能
alpaca-py-cli 是一款基于 Python 的 Alpaca Markets 交易 CLI 工具，为 OpenClaw Agent 提供股票和加密货币的程序化交易能力。
核心用法：
- 初始化配置：运行
alpaca init启动交互式向导，引导用户注册账户并配置 API 密钥 - 账户管理：
alpaca account查看账户状态、资金、购买力及盈亏 - 市场信息：
alpaca clock检查市场开盘状态，alpaca calendar查看交易日历，alpaca quote <symbol>获取实时报价 - 交易执行：
alpaca buy/sell <symbol> <数量>下达市价单，alpaca orders查看订单状态 - 组合管理：
alpaca positions查看持仓，alpaca history分析组合表现，alpaca close/close-all平仓 - 风险控制：
alpaca cancel/cancel-all撤销订单，支持模拟盘（$100k 虚拟资金）安全测试
显著优点：
- 零门槛入门：默认启用纸面交易（Paper Trading），新手可无风险练习
- 交互式安全设计：密钥输入隐藏，配置需用户显式授权，避免自动化风险
- 自然语言友好：Agent 可通过对话理解用户交易意图并执行
- 轻量高效：Token 优化设计，运行时动态加载指南
潜在局限：
- 仅限市价单：目前不支持限价单、止损单等高级订单类型
- 美股市场局限：仅支持 Alpaca 覆盖的美股和加密货币，无港股/A股
- 依赖环境变量：API 密钥存储于 shell 配置，多设备需重复配置
- 实时性限制：闭市时报价数据可能不完整
适合人群：
- 量化交易初学者，希望通过模拟盘学习程序化交易
- 需快速查看持仓、执行简单交易的个人投资者
- 希望通过自然语言与 Agent 协作的自动化交易用户
常规风险：
- 资金安全：切换至实盘（Live Trading）前务必充分测试，误操作可能导致真实亏损
- 密钥泄露：环境变量虽为标准做法，但 shell 访问权限意味着其他进程可能读取
- 市场波动：市价单在波动剧烈时可能以不利价格成交
- 技术依赖：API 服务中断或本地配置错误可能导致交易失败
安全等级说明
本工具采用多重安全设计：纸面交易默认、交互式密钥配置、隐藏输入、用户显式授权。但涉及真实资金交易和 API 密钥管理，需用户具备基础安全意识。