核心用法
Xerolite是一个将TradingView交易信号桥接到Interactive Brokers (IBKR)的执行层工具，本skill将其封装为OpenClaw可调用的REST API接口。主要功能包括三类操作：
1. 订单下单（order place）
通过xerolite.mjs order place命令发送交易指令，支持股票、期权等多资产类别。必需参数为--action（BUY/SELL）、--qty（数量）、--symbol（代码）；可选指定--currency（默认USD）、--asset-class（默认STOCK）、--exch（默认SMART智能路由）。API调用POST /api/agentic/order/place-order，需X-Agentic-Api-Key认证。
2. 合约搜索（contract search）
用于查询IB可交易的合约详情，验证代码有效性。调用POST /api/agentic/contract/search，返回合约的完整元数据（conid、交易所、乘数等），避免下单因合约不规范被拒。
3. 持仓查询（portfolio get）
获取当前IB账户的实时持仓列表，调用POST /api/agentic/portfolio，返回JSON数组格式的仓位数据，支持自动化风控和P&L计算。
显著优点
- 零延迟桥接：TradingView webhook → Xerolite → IB TWS/IB Gateway的链路设计，消除手工下单的时间损耗
- 多资产支持：通过
asset_class参数覆盖股票、期权、期货、外汇等IB支持的全品类 - 智能路由默认：SMART交易所设置让IB自动选择最优执行场所
- Agentic API设计：REST接口专为程序化调用优化，JSON格式标准化
潜在缺点与局限性
- 本地化依赖：默认API URL为
http://localhost，意味着Xerolite服务端需在本地运行，云部署需额外配置XEROLITE_API_URL - 单一经纪商锁定：仅支持IBKR，无法直接切换至其他券商
- 无订单状态回调：文档未提及订单成交确认、部分成交、拒单等状态的事件通知机制
- 风控层缺失：skill本身无内置仓位限制、单日亏损止损等风控逻辑，需调用方自行实现
- Node.js环境依赖：执行脚本需要Node 18+，部分隔离环境可能受限
适合人群
- TradingView策略开发者：已将策略部署为Pine Alert，需自动化执行
- 个人量化交易者：拥有IB账户，追求低延迟、低成本（IB佣金优势）的自主交易方案
- 小型交易团队：需要快速搭建"信号→执行→监控"闭环，但无需完整OMS系统的场景
常规风险
| 风险类型 | 说明 |
|---------|------|
| 密钥泄露风险 | `XEROLITE_AGENTIC_API_KEY`具备下单权限，需严格保护；建议通过环境变量注入而非硬编码 |
| 网络连通性风险 | localhost依赖意味着本地Xerolite进程必须存活，崩溃或端口占用将导致指令失效 |
| 订单参数错误风险 | 符号格式（如`AAPL` vs `AAPL-USD-SMART`）、数量单位（ especially for options/futures）需与IB规范对齐 |
| 无沙盒模式 | 未提及模拟交易环境，测试需使用真实IB账户（或IB模拟账户），存在意外成交风险 |
| 并发与幂等 | API未说明订单重复提交的处理逻辑，高频调用需调用方实现幂等控制 |