Hyperliquid 钱包审计

安装指南

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

什么是

Hyperliquid 钱包审计会针对指定网络和时间范围，记录公开钱包的成交、费用、资金费、未结订单以及当前余额或持仓。它会生成诊断报告，将观察到的历史活动与当前敞口区分开来，并说明现有证据能够和不能够支持哪些结论。
此工具专为 Openclaw Skills 工作流程设计，无需连接钱包、登录、私钥或交易权限。精确的 API 请求和响应、每次读取的时间戳以及 SHA256 哈希支持本地验证和离线复现；但它们本身不能证明交易所的真实性，也不能证明捕获的时间范围完整。

应用场景

调查公开 Hyperliquid 钱包在指定的首尾均包含的时间范围内的活动。
按市场拆分默认永续合约的已平仓 PnL、费用和返佣、资金费、maker/taker 名义金额占比及费用集中度。
将当前默认永续合约持仓、现货余额和未结订单与历史交易活动分开审查。
保存原始 API 证据，并从捕获文件离线复现报告。
生成合成示例，以检查报告格式而不发送网络请求。
在钱包诊断中记录覆盖范围缺口、缺失读取、计价单位限制或账户范围不确定性。

工作原理

确定公开账户地址、网络、首尾均包含的开始和结束时间，以及新的输出目录。确认该地址属于预期的用户、子账户或金库。
从官方 Hyperliquid Info API 顺序捕获只读请求，包括用户角色、账户抽象、清算所状态、现货清算所状态、前端未结订单、按时间查询的成交记录以及资金费。
对分页数量、超时和响应大小施加上限。将失败的 HTTP 或网络读取记录为缺失证据，而不将其视为零活动，也不无限重试。
验证账户、网络、时间戳、数值和活动标识。验证请求/响应 SHA256 清单并对相同活动去重；拒绝格式错误或相互冲突的记录。
分析有证据支持的默认永续合约已平仓 PnL、带符号的费用和返佣、资金费、maker/taker 名义金额占比及各市场费用集中度。保留费用的计价单位；不要再次添加 builderFee，因为它已包含在 fee 中。
将当前持仓和现货余额与历史活动分开报告。对于统一保证金或组合保证金账户，使用现货余额作为交易余额来源，且不要将其加到永续合约 accountValue 中。
提供报告文件，并清楚说明观察到的结果、有证据支持的发现、覆盖范围限制及相关账户范围注意事项。API 数据耗尽并不能证明活动时间范围完整。

配置指南

要求：运行随附的无依赖脚本需要 Node.js 20 或更高版本。实时捕获使用公开账户地址和官方 Hyperliquid Info API；离线分析只需要捕获文件。
从已安装的技能目录运行合成示例：
node scripts/wallet-audit.mjs example --out ./wallet-audit-example --json
进行实时捕获时，请将示例地址和日期替换为所需的公开输入。结束时间不得晚于当前时间；请使用新的输出目录：
node scripts/wallet-audit.mjs capture
--address 0x1111111111111111111111111111111111111111
--network mainnet
--start 2026-10-01T00:00:00Z --end 2026-10-02T00:00:00Z
--max-pages 10 --out ./wallet-audit-live --json 从捕获的输入离线复现报告：
node scripts/wallet-audit.mjs analyze --input ./wallet-audit-live/capture.json
--out ./wallet-audit-reproduced --json 已安装的技能可以独立于软件包 CLI 和其他技能运行。如果代理没有 shell，请使用其现有的 HTTP 能力发送文档中说明的请求正文，保留精确的源响应；除非确实运行了确定性辅助程序或验证了哈希，否则不要声称已运行或验证。
Hyperliquid 钱包审计 数据架构与分类体系
输出目录包含：
路径 用途
capture.json 捕获的读取结果和元数据，作为分析及离线复现的输入。
report.json 遵循已记录输出规范的机器可读诊断报告。
report.md 以人类可读形式呈现的发现、解读和覆盖范围注意事项。
evidence/ 为各项读取保留的精确原始请求和响应。
每次读取均包含独立的开始/结束时间戳和 SHA256。各次读取是按顺序进行的观察，并非一次原子快照，也不是时间范围结束时的历史账户状态。清单可验证其与本地捕获文件的一致性，但不能独立证明交易所的真实性。
分析会在稳定的输出架构中将十进制值保留为字符串。它保留费用的原始代币计价单位，将历史成交和资金费与当前持仓及现货余额区分开来，并将失败的读取记录为缺失证据。根据首次观察到的成交推断初始库存仅是一项观察，并不能证明时间范围开始时的持仓。其他 DEX 的持仓不在该辅助工具的敞口范围内。

高级特性

有界捕获控制可限制分页数、请求时长和响应字节数；辅助工具仅接受两个官方网络端点和指定的读取类型。
请求/响应 SHA256 清单验证和活动去重支持可复现的本地分析。
故障关闭式验证会拒绝格式错误的数字、不安全的标识、相互冲突的重复项、账户或网络不匹配的数据，以及超出时间范围的记录。
离线分析可以从捕获文件重新生成报告，而无需发出新的 API 请求。
合成示例模式无需网络访问即可运行；其中的测试数据并非交易所记录。
报告会区分当前敞口和历史活动，保留费用计价单位，并避免对 builderFee 重复计数。
只读边界：不包含签名器、交易所提交、后台调度程序或跟单交易执行器。
辅助工具无法证明完整时间范围的收益、盈利能力排名、胜率、风险调整收益、策略有效性或止损覆盖情况。保护状态仍未评估；执行这些任务时，请使用独立功能和适当证据。

name: hyperliquid-wallet-audit description: "Capture and audit a public Hyperliquid wallet's bounded fills, fees, funding, open orders and current exposure with reproducible raw evidence. Use when the user wants a wallet diagnostic, trading-cost breakdown or deterministic analysis of a captured activity window without connecting or signing. Read-only; not for copy rankings, complete portfolio returns or execution." license: MIT
compatibility: "Requires Node.js 20 or newer for bundled dependency-free scripts. Live capture uses the public Hyperliquid Info API and a public user-account address; offline analysis needs only a capture file."