核心概述
OpenBroker 是 Hyperliquid DEX 的专业级交易工具套件，以 Node.js CLI 为核心，提供从基础下单到复杂自动化策略的全栈能力。核心功能覆盖现货与永续合约交易（含 HIP-3 跨 DEX 资产）、背景仓位监控、事件驱动型自动化脚本，以及通过 webhook 实现的实时告警推送。
核心用法
基础交易：支持市价/限价/触发订单、TWAP 拆单、网格加仓、追踪委托（Chase）等高级执行方式。HIP-3 资产需使用 dex:COIN 格式（如 xyz:CL）。
自动化引擎：TypeScript 脚本订阅实时事件（价格变动、资金费率、仓位变化、PnL 阈值、保证金告警等），通过 api.client 调用完整 Hyperliquid SDK，配合持久化状态 api.state 实现跨重启策略连续性。
背景监控：独立 watcher 进程每 30 秒轮询账户，检测仓位开平、PnL 大幅波动、强平风险，通过 webhook 唤醒 Agent 推送告警。
显著优点
- 执行深度：原生支持 Hyperliquid 特有功能（builder fee、HIP-3 跨 DEX、统一账户模式）
- 实时性：WebSocket 订阅毫秒级订单生命周期与价格变动，REST 作为心跳兜底
- 自动化成熟度：事件驱动架构 + 持久化状态 + 优雅关闭钩子（
onStop清理仓位/订单） - 风险感知：内置保证金告警（80% 阈值）、PnL 波动检测（5% 阈值）、强平事件订阅
- 双模式运行：既可纯 CLI/Bash 独立使用，也可作为 OpenClaw 插件启用结构化工具与背景监控
潜在局限与风险
- 资金门槛：需预先在 Arbitrum 充值 USDC 并跨链至 Hyperliquid L1
- API 钱包限制：子账户无法执行提现操作，需主钱包浏览器签名授权
- WebSocket 依赖：部分事件（强平告警）仅 WebSocket 提供，断线时降级为 10 秒 REST 轮询
- 策略风险：捆绑示例（DCA/网格/资金费率套利）仅为参考模板，直接运行缺乏针对币种的风控参数
- 托管风险：私钥以明文存储于
~/.openbroker/.env，需确保文件系统权限
适合人群
- 量化交易者与 DeFi 策略开发者
- 需要 7×24 仓位监控与自动风控的活跃交易员
- OpenClaw 生态用户寻求 Agent 原生交易能力
- 已熟悉 Hyperliquid 机制、能接受链上自托管风险的中高级用户
常规风险提示
- 强制平仓：永续合约高杠杆下，价格剧烈波动可能导致保证金不足被清算
- 资金费率成本：持仓跨越资金结算时点可能产生正/负费率支出
- 智能合约风险：Hyperliquid 作为衍生品 DEX 存在合约漏洞与升级风险
- 网络与 API 风险：私钥本地存储、网络延迟导致的滑点或订单失败
- 自动化误触发：事件订阅逻辑需充分测试，建议
--dry模拟后再实盘运行