核心用法
OpenBroker 是 Hyperliquid 去中心化交易所的官方命令行交易工具，提供完整的现货与永续合约交易能力。用户通过 npm install -g openbroker 安装后，执行 openbroker setup 完成钱包配置与 Builder Fee 授权即可开始交易。
基础交易操作：
- 市价单：
openbroker buy/sell --coin ETH --size 0.5 - 限价单：
openbroker limit --coin BTC --side buy --size 0.1 --price 65000 - 止盈止损：
openbroker tpsl --coin SOL --tp +10% --sl -5% - 高级执行：TWAP 拆单、网格交易、追踪委托 (Chase Order)、括号订单 (Entry+TP+SL)
资产发现： Hyperliquid 支持主站永续合约、HIP-3 跨 DEX 永续合约（如 xyz:GOLD、km:USOIL）及现货市场。交易前务必使用 openbroker search 或 ob_search 工具确认正确代币符号。
自动化策略： 核心差异化功能。用户可编写 TypeScript 脚本实现事件驱动交易，支持：
- 实时事件订阅（价格变动、资金费率更新、仓位变化、订单状态、PnL 阈值、保证金预警、清算事件）
- 持久化状态存储（
api.state） - WebSocket 实时数据流 + REST 心跳轮询
api.publish()向 Agent 发送预警通知
内置示例策略：DCA 定投、网格交易、资金费率套利、做市商策略，但官方强调这些仅为参考模板，生产环境需根据具体需求定制开发。
OpenClaw 插件扩展： 同名 npm 包同时提供 ob_* 系列结构化工具，支持后台仓位监控（30秒轮询）、PnL 异动与强平风险自动告警、以及通过插件工具启停自动化策略。
显著优点
1. 完整的 Hyperliquid 功能覆盖：原生支持 Builder Fee（1bps）、HIP-3 跨 DEX 资产、API 子钱包（仅交易不可提现）
2. 灵活的执行方式：CLI 成熟稳定、OpenClaw 插件提供结构化接口，二者可无缝切换
3. 强大的自动化框架：基于 TypeScript 的声明式事件系统，30+ 种客户端方法，支持复杂策略开发
4. 实时风险监控：WebSocket 推送订单生命周期、清算事件；内置保证金使用率（>80%）与 PnL 波动（>5%）预警
5. 安全设计：--dry 预览模式、自动价格/数量精度处理、强平价格计算、减少仅订单 (--reduce)
潜在缺点与局限性
1. 技术门槛较高：自动化策略需要 TypeScript 编程能力，非技术用户难以充分利用
2. 资金安全风险：DeFi 协议智能合约风险、API 密钥管理责任在用户，私钥泄露即资产失控
3. 网络与延迟依赖：WebSocket 断线后 fallback 到 10 秒轮询，高频策略可能受影响
4. HIP-3 资产复杂性：跨 DEX 资产需要 dex:COIN 格式前缀，容易因符号错误导致交易失败
5. API 速率限制：存在 nRequestsCap 限制，高频数据调用需注意配额管理
适合人群
- 量化交易者：需要程序化执行与自定义策略的 DeFi 原生用户
- Hyperliquid 重度用户：已熟悉该平台，需要 CLI 效率提升
- 自动化需求者：希望实现 DCA、网格、资金费率套利等无人值守策略
- 风险主动管理者：需要实时监控仓位、设置多层预警的专业交易者
不适合纯新手或不愿承担智能合约风险的用户。
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 智能合约风险 | Hyperliquid 协议漏洞或升级问题 | 小额测试、关注官方公告 |
| 私钥泄露 | `HYPERLIQUID_PRIVATE_KEY` 环境变量泄露 | 使用 API 钱包限制权限、加密存储 |
| 清算风险 | 高杠杆仓位波动导致强平 | 设置 SL、监控 `margin_warning`、控制杠杆 |
| 策略逻辑错误 | 自动化脚本 bug 导致意外交易 | 充分 `--dry` 测试、小额实盘验证 |
| 网络/节点风险 | API 延迟或不可用 | 监控 `rate-limit`、设置超时重试 |
| 无常损失/资金费率 | 持仓资金成本或对冲偏差 | 监控 `funding_update`、及时调仓 |