Hyperliquid Setup

安装指南

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

什么是

Hyperliquid Setup指导Agent从已安装的指令过渡到对指定Hyperliquid市场的首次验证读取。它会检查Agent Harness实际暴露的工具，验证市场数据，并记录哪些工作流可用或仍需要能力。
此Openclaw Skills集成将公开分析与账户访问和交易执行区分开来：公开读取不需要钱包或密钥，账户读取需要用户提供公开账户地址，而执行则需要单独配置的可信签名者。Setup本身不会授权交易或处理私钥。

应用场景

在安装Hyperliquid Skill Pack后开始使用，并验证公开市场数据是否可以访问。
检查哪些工具可用于市场分析、账户监控、规划、未签名Ticket构建或执行。
诊断缺失工具、不完整数据、过时的Order-Book信息或不支持的工作流。
在明确选择的 Mainnet 或 Testnet 上读取特定市场，而无需提供账户凭证。
在请求账户读取或交易执行之前确定需要哪些条件。
创建可用性记录，帮助将请求路由到合适的已安装Skill或进行 Hand Off。

工作原理

盘点 Harness 的实际工具，例如浏览器或 HTTP 访问、Shell 或 Node.js、账户读取、未签名 Ticket 构建、签名者提交以及对账。不要因为 Skill 中提到了某个工具或钱包就假设它存在。
查看连接和首次运行说明，然后明确选择 Mainnet 或 Testnet。复用用户的环境选择，除非它改变了任务。
对具体请求的市场执行一次公开读取。使用提供的 Node.js 脚本或文档化的 HTTP 请求；不要将 Fixture 当作当前市场证据。
验证网络、代币、元数据精度、Order-Book 时效性和响应覆盖范围。报告 Mark 和 Oracle 价格、价差、汇报的资金费率、观察时间以及局限性。将缺失数据视为不可用，而不是零。
将请求的工作流与可用能力进行匹配。对账户读取请求公开用户或子账户地址，并要求执行时使用已存在的可信签名者。切勿在 Setup 过程中处理密钥或批准 API 钱包。
生成一份可用性记录，包含网络、工具名称、支持的操作、证据、缺失的能力、可用工作流以及下一步操作。路由到合适的已安装 Skill 或提供本地 Hand Off 协议指定的明确安装命令。
仅当首次读取具有带时间戳的结果或明确的诊断失败，且 Agent 能够说明其目前能做什么以及什么仍然不可用时，才标记 Setup 完成。

配置指南

使用与 Agent Skills 兼容的 Harness。对于公开读取，提供 HTTP 访问或 Node.js 20+。账户工作还需要用户提供公开账户地址；执行则需要单独配置的可信签名者。Setup 不需要也不授权钱包或密钥。
在连接工具前查看 Skill 参考资料：references/official-tools.md 了解维护的上游能力，references/connections.md 了解网络选择和首次运行流程，references/agent-integration.md 了解能力映射和 Hand Off。
在此 Skill 的目录下，运行公开市场读取，替换请求的代币和网络：
node scripts/market-snapshot.mjs --coin ETH --network mainnet
如果 Shell 访问不可用，请使用 Skill 连接说明中记录的两个 HTTP 请求。提供的 Skill 中未指定单独的软件包安装命令。不要将 Fixture 用作当前证据，不要处理密钥，也不要将配置 API 钱包作为 Setup 的一部分。

数据架构

该 Skill 未指定持久化数据库或生成的文件格式。其核心结构化输出是一份可用性记录：
字段 内容
网络 明确选择的 Mainnet 或 Testnet
工具名称 Harness 暴露的确切工具
支持的操作 每个工具可以执行的操作，例如公开读取或账户读取
证据 首次公开读取的带时间戳结果，或明确的诊断失败
缺失的能力 当前不可用的工具、数据或访问权限
可用工作流 仅在支持时提供分析、账户监控、规划或执行
下一步操作 一个具体的步骤，包括在需要时提供适当的 Hand Off
对于市场读取，请验证请求的代币、网络、元数据精度、Book 时效性和响应覆盖范围。报告 Mark/Oracle 价格、价差、汇报的资金费率、观察时间以及局限性。缺失值视为不可用而非零。Skill 元数据标识版本为 0.4.0，协议为 hyperliquid；支持性说明组织在 references/ 下。

高级特性

能力发现基于 Harness 实际暴露的工具，而非假设的 MCP 服务器、钱包或集成。
支持明确选择 Mainnet 或 Testnet，并在无需账户凭证的情况下进行首次公开市场读取。
鼓励复用合适且维护良好的上游工具，同时保持工具采用的深度可选性，并与钱包权限分离。
将公开市场分析、账户读取、未签名 Ticket 构建、签名者提交和对账划分为独立的能力。
验证数据覆盖范围和时效性，并报告局限性，而不是将缺失数据视为零。
提供工作流 Hand Off 和可用性记录，使不可用的能力和下一步操作保持明确。
将 Setup 与授权保持分离：不处理私钥，不批准 API 钱包，且执行需要单独配置的可信签名者。

name: hyperliquid-setup description: "Connect an agent's available tools to Hyperliquid workflows and complete a first public market read. Use when installing this pack, asking how to get started, diagnosing missing data or tools, or checking whether analysis, account monitoring, planning, or execution is available. Setup does not authorize trading or configure private keys." license: MIT
compatibility: "Any Agent Skills harness. Public reads need HTTP access or Node.js 20+. Account work needs a user-provided public account address; execution needs a separately configured trusted signer."