Hyperliquid 计划

安装指南

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

什么是

Hyperliquid Plan 会为用户选定的操作准备未签名委托单，包括开仓、平仓、减仓、取消、修改、触发订单、TWAP、杠杆调整和逐仓保证金调整。它会收集相关账户和市场状态，检查特定操作的要求，并记录供审核所需的订单详情和防护措施。
作为 Openclaw Skills 的一部分，它支持有纪律的交易准备，同时将计划与执行分开。它不会选择市场、实时监控仓位、请求签名、暴露密钥或提交订单；委托单完成后，必须另行明确处理执行。

应用场景

用户选定市场和交易意图后，准备开仓或平仓委托单。
在增加敞口前计算下单规模，并检查亏损、敞口、保证金、费用和滑点限制。
使用特定操作所需的输入，规划减仓、取消、订单修改、触发订单、TWAP、杠杆调整或逐仓保证金调整。
在决定计划是否可执行前，审查当前账户和市场状况。
当缺少实时预检字段或风险输入时，提供明确标注的假设性规模计算示例。
将完整委托单移交给独立的执行流程，无需签名或提交。

工作原理

收集网络、公开账户、目标市场或 DEX、预期操作及任何必要的用户限制；不得臆测身份、支出限额或风险承受能力。
将计划重新绑定到当前账户和市场状态，包括账户模式、资产标识符、精度规则、价格、深度、费用、仓位、未结订单、余额、可交易资金和杠杆。
执行账户模式和特定操作的检查。对于增加敞口的订单，使用风险规模计算指南，并计入不利止损滑点以及进场和出场费用。
确定目标网络的订单语义、标识符和精度。将规模向下取整至当前 szDecimals，并应用当前价格跳动单位和有效数字规则。
模拟可能的结果，例如拒绝、挂单、全部或部分成交、等待触发、保证金取消、响应未知和账户状态不匹配。
为每个订单腿分配新的 128 位客户端订单 ID，并在签名方案支持时记录 expiresAfter 值。
检查交易所限制、用户限额、速率限制、价格容差、可用保证金、交易后保证金等级、未平仓总风险、相关敞口和结果仓位保护。
输出未签名委托单以供审核。不得请求签名，也不得声称计划或模拟改变了交易所状态。

配置指南

在 OpenClaw 技能环境中提供 Hyperliquid Plan 技能。
如需制定可执行计划，请连接适当的只读市场和账户访问权限。该技能不需要也不会授予钱包签名权限。
安装 Node.js 20 或更高版本，以使用捆绑的确定性风险算术脚本。
首次使用时，或缺少相关工具或技能时，请查阅代理集成与交接参考。选择集成前请查看官方工具参考；上游工具为可选项。
node --version
node scripts/risk.mjs --help
第二条命令假设 shell 当前运行于技能目录中。准备可执行计划前，请提供网络、公开账户、目标市场或 DEX、操作，以及任何重要的特定操作风险输入。

数据架构

该技能会输出未签名委托单以供审核；所提供的文档指向单独的委托单契约，其中包含完整字段规范。工作流程要求委托单记录适用的操作和订单详情、当前身份与状态、风险和恢复检查，以及到期信息。
数据类别 技能中描述的详情
身份和市场 网络、账户、账户抽象模式、DEX、币种名称、资产 ID 和 szDecimals
实时预检状态 价格规则、保证金表、标记价格、预言机价格、中间价、深度、实际费用、仓位、未结订单、余额、可交易资金和当前杠杆
操作和风险 特定操作的订单字段、适用时的规模计算、用户限额、费用、滑点、保证金等级、未平仓总风险、相关敞口和仓位保护
订单生命周期 每个订单腿使用新的 128 位客户端订单 ID、受支持的 expiresAfter 值，以及部分成交或响应未知等模拟结果
技能文件和元数据 SKILL.md 标明版本为 0.4.0，协议为 hyperliquid；工作流程链接到有关账户模式、风险规模计算、订单语义、意图与偏好、委托单契约、官方工具和代理集成的参考资料
将不相关字段标记为不适用，并说明原因。重要计划输入发生变化时——包括账户、市场、方向、规模、价格、触发条件、杠杆、费用、客户端 ID、到期时间或保护措施——批准即失效。

高级特性

通过捆绑的
scripts/risk.mjs
脚本进行确定性风险算术计算，该脚本要求 Node.js 20 或更高版本。
针对标准、统一和组合保证金账户，执行考虑账户模式的预检。
特定操作的验证可区分增加敞口的订单与取消、减仓及其他操作。
明确将 IOC 市价类订单视为限价订单，并设置可接受的最差价格；API 不提供无价格限制的市价单。
对平仓、止损和止盈要求仅减仓，并处理标记价格触发及单独的可执行价格界限。
规划部分成交的风险控制，包括 IOC 开仓订单部分成交后可能留下未受保护敞口的风险。
每个订单腿使用新的客户端订单 ID；在支持时可选记录到期时间；重要审批输入变更时使审批失效。
可选复用维护中的上游工具，但不授予这些工具钱包权限。
严格限定在计划阶段：不签名、不暴露密钥、不提交、不实时监控，也不声称交易所状态已发生变化。

name: hyperliquid-plan description: "Build an exact unsigned Hyperliquid ticket for an entry, exit, reduction, cancel, modify, trigger order, TWAP, leverage change, or isolated-margin change. Use when the user has chosen an intent and asks for size, limits, order fields, risk checks, or a preflight plan. Planning only; not for market selection, live monitoring, signing, or submission." license: MIT
compatibility: "Requires read-only market and account access for executable plans. The bundled risk script needs Node.js 20 or newer."