Open-broker

核心概述

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 模拟后再实盘运行

OpenBroker 综合评估

OpenBroker 是一个面向 Hyperliquid 去中心化交易所的专业交易 CLI 工具，由 monemetrics 团队开发并维护。该 Skill 本身为纯文档型包装器，实际功能通过调用外部 openbroker npm 包实现，支持完整的交易生命周期管理。

核心用法

基础交易：支持市价/限价订单、止盈止损设置、TWAP 执行、网格交易等常见操作，覆盖 ETH、BTC、SOL 等主流资产以及 HIP-3 协议的创新衍生品（如 xyz:CL 原油、xyz:GOLD 黄金等）。

自动化策略：提供 TypeScript 编写的事件驱动自动化框架，支持 price_change、funding_update、position_opened、margin_warning 等 10+ 种事件订阅，可构建 DCA、资金费率套利、突破追踪等策略。内置持久化状态管理和 webhook 告警机制。

后台监控：可选 OpenClaw 插件提供 30 秒轮询的仓位监控，自动检测 PnL 波动（≥5%）、保证金使用率（≥80%）等风险信号并触发代理通知。

显著优点

• 功能完整：覆盖查询、交易、风控、自动化全链路，支持 HIP-3 新型资产
• 开发者友好：提供 40+ 个结构化工具（ob_buy、ob_limit 等），CLI 与插件双模式
• 风险机制：支持 --dry 预览、测试网模式、API Wallet（限制提现权限）、强制 TP/SL 建议
• 事件驱动：自动化框架设计合理，事件粒度细（tick/price/funding/position/order 等），适合构建复杂策略
• 合规透明：MIT 开源协议，npm 正规发布，T2 可信来源认证

潜在缺点与局限

• 私钥依赖：必须配置 HYPERLIQUID_PRIVATE_KEY，存在密钥泄露风险（Skill 本身不存储，但调用环境需保障）
• 外部依赖：核心逻辑在 npm 包中，Skill 仅为包装器，实际安全性取决于 CLI 实现
• 平台集中风险：Hyperliquid 为中心化订单簿 DEX，存在平台运营和智能合约风险
• 学习曲线：HIP-3 资产前缀规则（dex:COIN）、事件系统、自动化 API 需一定学习成本
• 网络限制：需访问 api.hyperliquid.xyz，部分地区可能存在连接问题

适合人群

• 有一定编程基础的量化交易者
• 需要自动化执行策略的 DeFi 用户
• 熟悉 Hyperliquid 生态的活跃交易者
• 愿意承担衍生品交易风险、具备风险意识的投资者

常规风险

1. 资金风险：加密货币交易存在爆仓、清算可能，自动化策略可能因市场极端波动导致损失
2. 密钥安全：私钥泄露可导致资金被盗，建议使用 API Wallet 模式并限制权限
3. 策略风险：自动化脚本可能因逻辑缺陷、网络延迟、价格插针等原因产生非预期交易
4. 平台风险：Hyperliquid 作为中心化交易所，存在平台故障、维护、监管等外部风险
5. 技术风险：CLI 或插件 bug 可能导致订单异常，建议充分测试后再投入实盘