Hyperliquid 监控

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install galleon-hyperliquid-monitor
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 galleon-hyperliquid-monitor。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

Hyperliquid 监控是一项面向 Hyperliquid 的只读账户与仓位对账技能。它整合当前交易所数据来评估余额、仓位、未结订单、保护措施、成交、资金费和清算估算，同时区分已确认的观察结果与过期、不完整、失败或不可用的读取结果。
它专为使用 Openclaw Skills 的开发者和智能体设计，支持一次性账户检查和条件监控。它会报告事实以及下一步所需的读取或未签名操作；绝不会下单、更改、取消或平仓。

应用场景

检查指定 Hyperliquid 账户当前有哪些未平仓仓位和订单。
验证未平仓仓位是否有相匹配的保护性止损，并确认其方向、数量、触发条件、仅减仓状态和仓位关联均符合要求。
通过对账订单状态、未结订单、成交和仓位状态，判断订单是否已成交。
查看资金费、账本变更、费率等级、余额和操作预算。
在考虑全仓、统一或组合保证金依赖关系的同时，评估清算临近程度。
监控指定条件，并在其已触发、未触发或不可用时发出提醒。
调查 WebSocket 重新连接后的数据缺口，或区分新的成交活动与初始订阅快照。

工作原理

将请求绑定到网络、受监控账户地址、账户抽象模式、DEX、相关市场、观察时间、新鲜度界限和指定条件。
读取受监控账户或子账户的权威状态，而不是 API 钱包地址；必要时参考该技能的工具选择和集成指南。
对账仓位、余额、未结订单、触发详情、订单状态、成交、资金费、账本更新、费率等级和操作预算。适用统一或组合保证金时，纳入现货清算所和借贷状态。
检查每个未平仓仓位的保护措施和异常情况。使用详细的未结订单数据验证触发条件和仅减仓属性。
将资金费标准化为其声明的时间间隔，同时保留从账户角度计算的正负号。
对于持续监控，先创建快照、对事件去重、维持心跳、检测缺口，并在重新连接后进行对账。
将指定条件准确分类为 triggered、not-triggered 或 unavailable。读取失败、为空、过期、不完整或存在缺口时，应判定为不可用，而不能据此认定账户正常或为空。
报告当前状态、重要变更、数据缺口和下一步所需的读取。提醒只陈述事实并启动计划；不会执行操作。

配置指南

向兼容的 AI 智能体提供 Hyperliquid 监控技能及其参考文件。
提供用户的 Hyperliquid 账户地址和只读 API 访问权限。不得用 API 钱包地址替代受监控的账户或子账户地址。
指定网络，并在相关时提供账户抽象模式、DEX、市场、新鲜度界限和监控条件。仅询问缺失的身份信息或监控约束。
查看随附参考资料，了解官方工具、权威状态、保护措施和异常、数据流规范、输出约定及智能体集成。可选择是否采用工具，采用工具不会授予钱包权限。
使用随附资金费脚本需要 Node.js 20 或更高版本。使用以下命令查看其支持的选项：
node scripts/funding.mjs --help
不得向此只读技能授予交易所操作凭据或权限。对于下单、修改、取消、平仓、调整杠杆、转账或提交交易所操作的请求，应将其转交给 hyperliquid-plan 或 hyperliquid-execute。

数据架构

该技能使用以下 frontmatter 元数据：
字段 值或用途
name hyperliquid-monitor
description 定义只读对账和监控范围，包括禁止的交易所操作。
license MIT
compatibility 需要只读 Hyperliquid API 访问权限和用户账户地址；资金费脚本需要 Node.js 20 或更高版本。
metadata.version 0.4.0
metadata.protocol hyperliquid
对于每次观察，工作流程都会绑定网络、账户和抽象模式、DEX、市场、观察时间、新鲜度界限及指定条件。它会对账账户实体，包括仓位、余额、订单及触发详情、成交、资金费、账本更新、费率等级和操作预算；统一或组合保证金检查还会纳入现货清算所和借贷状态。
输出遵循所引用的监控约定，并将条件分类为 triggered、not-triggered 或 unavailable。技能文档未指定持久化存储格式或生成的数据文件。随附的 scripts/funding.mjs 支持资金费计算；脚本选项请查看其帮助输出。

高级特性

持续监控规范：先创建快照再开始数据流、对事件去重、发送心跳、检测缺口，并在重新连接后进行对账。
可靠的事件解读：不要将 fills 订阅的首条消息视为新活动，也不要将订单响应文本视为最终状态。
使用详细的未结订单数据检查触发条件和仅减仓属性，并结合仓位状态验证保护措施。
按资金费数据流声明的时间间隔标准化资金费，并保留从账户角度计算的正负号。
考虑保证金的风险审查：将
liquidationPx
视为实时估算值，并考虑仓位与余额之间相互关联的风险。
明确处理不可用状态：读取失败、过期、不完整、为空或存在缺口时，不会将缺失数据误报为安全。
严格遵守只读边界：提醒只报告事实并启动计划，不能执行交易所操作。

name: hyperliquid-monitor description: "Reconcile a Hyperliquid account, position, order, fill, funding stream, liquidation buffer, or watch from current exchange data. Use when the user asks what is open, whether protection exists, whether an order filled, how close liquidation is, what changed, or to watch and alert on a condition. Read-only; not for placing, changing, or canceling orders." license: MIT
compatibility: "Requires read-only Hyperliquid API access and the user account address. The bundled funding script needs Node.js 20 or newer."