Hyperliquid Engineer

安装指南

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

什么是

Hyperliquid Engineer 是一项工程技能，用于实现或审查行情数据客户端、账户集成、订单流、签名、WebSocket 消费者、风险控制以及自动化。它引导开发者查阅最新的官方文档和维护中的 SDK，然后对集成进行结构化设计，使身份识别、读取、风控检查、签名、提交和对账保持清晰分离。
Openclaw Skills 用户可以应用其注重生产环境的规则，以减少不安全的写入和模糊的状态：默认进行干跑（dry-run），将私钥保持在 Agent 上下文和协议适配器之外，保留精确的传输值，并区分 API 响应与已确认的交易所状态。它支持工程建设工作，而不是选择交易或授权账户操作。

应用场景

为 Hyperliquid 构建 SDK 集成、交易所适配器、机器人或行情数据观察器。
在不修改文件的情况下审查现有的集成。
使用与官方 SDK 对齐的奇偶校验测试用例调试签名不匹配问题。
添加对账户模式、DEX、产品类别或特定网络行为的支持。
明确处理 WebSocket 快照、更新、断开连接、数据缺失、重连和追溯补全。
针对拒绝、部分成交、延迟响应或未知结果，强化订单提交与恢复机制。
创建本地测试用例，并在不使用生产签名器的情况下验证协议边缘情况。

工作原理

定义集成范围：支持的网络、产品、账户模式、DEX、读写操作、托管模型、吞吐量、延迟以及失败预算。
在依赖协议细节或常量之前，检查最新的官方 Hyperliquid 文档和维护的 SDK 版本。
审查相关的技能参考资料，涵盖工具选择、Agent 交付、适配器架构、API 不变量、流处理、安全性以及测试覆盖率。
将账户身份和读取操作与策略、风控检查、未签名动作构建、授权、签名、提交、响应解析、对账和审查清晰分离开来。
使用类型化的资产身份和整数或十进制字符串传输值来实现协议行为；在运行时解析变化的元数据和限制。
保护每一条写入路径：默认进行干跑，保持签名器材料隔离，按签名器对写入操作进行序列化，并在提交前持久化每个唯一的客户端订单 ID 和意图。
明确对待流和订单状态。处理快照、更新、缺口、重连、拒绝、部分成交、延迟响应和未知结果，切勿将不确定性转换为成功或零。
运行适用的测试矩阵用例和代码库检查，然后报告支持的合约、凭证、验证、不支持的操作、假设以及残留风险。

配置指南

使用宿主支持的技能加载流程将该技能提供给 Coding Agent。提供的 SKILL.md 未指定通用的安装命令或包管理器设置。
首次使用时，检查工具选择和 Agent 交付指南，以及任务所需的参考资料：
ls references
cat references/official-tools.md
cat references/agent-integration.md
在实现之前，请参阅相关的架构、API、流、安全性和测试矩阵参考资料。验证最新的官方文档并锁定适合项目的维护 SDK 版本。
建立支持的网络、账户和签名者身份、产品范围以及读/写权限。将私钥置于代码库、Agent 上下文和协议适配器之外；切勿在日常开发或验证中使用生产签名器。
从本地测试用例和干跑行为开始。Testnet 写入需要明确授权；本地测试用例不需要单独的交易批准。

数据架构

该技能未规定特定的数据库 Schema、生成的文件布局或存储格式。它定义了集成应当保留的数据区分和持久化预期：
数据或概念 必须的处理方式
账户身份 使用用户或子账户地址来识别账户状态。
签名者身份 将 API 钱包地址视为签名者和 nonce 域身份；保持私钥材料隔离。
资产与市场元数据 在运行时解析资产 ID、szDecimals、保证金表、DEX 索引、费率、账户模式和限制。保留类型化的资产身份。
传输值 用整数或十进制字符串表示协议数值；仅在展示时使用浮点值。
订单意图 在提交前持久化意图，并为每个订单单腿分配唯一的客户端订单 ID。在支持时，在签名载荷和恢复模型中包含 expiresAfter。
交易所结果 将返回的响应与已对账的交易所状态分开建模。保留被拒绝、陈旧、缺失和未知的状态，而不是将其视为成功、零或自动可重试。
流状态 区分快照、更新、缺口、重连和追溯补全；不要让 WebSocket 回调直接调用写入适配器。
验证产物 使用本地测试用例和测试矩阵用例进行协议对齐、拒绝、部分成交、延迟或未知结果、精度边界、账户模式、速率限制和恢复的测试。该技能不强制规定测试用例文件名。

高级特性

适配器架构将读取和身份与策略、风险、授权、签名、提交、对账和审查分离开来。
可选采用合适的维护良好的上游工具或 SDK 功能；工具选择绝不授予钱包权限。
动态解析不断变化的资产、账户、DEX、手续费、保证金和限制等元数据。
隔离签名指南，优先使用官方或经过审计的 SDK 签名，当必须进行手动签名时提供按字节对齐的奇偶校验测试用例。
幂等写入与恢复实践，包括针对每个签名者的串行化、发送前意图持久化、唯一客户端订单 ID 以及支持的
expiresAfter
处理。
针对快照、增量更新、流中断、重连和追溯补全的明确 WebSocket 生命周期管理。
针对协议边缘情况、部分执行、模糊结果、速率限制、账户模式和恢复的测试矩阵指南。
清晰的操作界限：允许将本地测试用例测试作为工程建设工作，测试网写入需要明确授权，常规开发绝对不能发送主网操作或使用用户的生产签名器。

name: hyperliquid-engineer description: "Implement or review Hyperliquid market-data, account, order, signing, WebSocket, risk, reconciliation, and automation software. Use when the user asks for an SDK integration, adapter, bot, watcher, test suite, signature debugging, account-mode support, or production hardening. Not for choosing a trade or executing a user's account action." license: MIT
compatibility: "Designed for typed integrations using current official APIs and SDKs. Architecture and safety rules apply in any language."