📦 Decker + Hyperliquid — 去中心化杠杆交易

# Decker + Hyperliquid (DEX) 技能 ## 目标 通过 Decker 在 Hyperliquid DEX 查询行情并执行订单。扩展主 decker 技能。 ## 速查表 | 用户说法 | 动作 | 备注 | |-----------|------|------| | "HL BTC 0.01 买入", "在 Hyperliquid 买入 ETH" | order-request exchange_id=hyperliquid | 确认流程 | | "HL 行情", "Hyperliquid BTC 价格" | Assistant API 或行情查询 | | | "HL 持仓", "Hyperliquid 持仓" | Assistant API | 需要 JWT | ## DECKER_API_URL https://api.decker-ai.com ## 下单（Hyperliquid） 在 order-request 中增加 exchange_id=hyperliquid： `` GET {DECKER_API_URL}/api/v1/link/slack/order-request?slack_user_id={sender_id}&symbol=BTC&side=buy&quantity=0.01&exchange_id=hyperliquid&openclaw_secret={OPENCLAW_SECRET} ` - exchange_id=hyperliquid 必填（执行 Hyperliquid DEX） - symbol：BTC、ETH 等（自动使用 USDT 永续合约） - quantity：合约数量 ## 前置条件 - 已注册 Decker 并绑定 Slack - user_settings.exchange_preference = hyperliquid，或下单时显式指定 exchange_id - 已绑定 Hyperliquid 密钥（Decker 设置 → 交易所 API 设置） ## Hyperliquid 密钥设置（供代理引导） 1. 创建 API 专用钱包：访问 https://app.hyperliquid.xyz/API → "Create API Wallet" 2. 备份私钥：创建时显示的私钥（以 0x 开头）请安全保存（仅显示一次） 3. 在 Decker 设置：登录 → 设置 → 交易所 API 设置 → Hyperliquid - API Key：钱包地址（0x…，42 位）— 可选 - Secret Key：私钥（0x…，64 位以上）— 必填 4. 选择交易所：将 exchange_preference 设为 "Hyperliquid" 后保存 5. 下单：在 Slack/Telegram 说 "HL BTC 0.01 买入" ⚠️ API Wallet 无法提款，仅用于交易。建议与主钱包分离。 ## 安全准则（吸收自 ClawHub hyperliquid-trading） 下单前： 1. 向用户确认交易参数（币种、数量、方向、价格） 2. 同时展示当前行情与已有持仓 3. 计算并告知预估成本/收益 仓位规模： - 订单超过账户资产 20% 时发出警告 - 根据余额推荐合适数量 价格与滑点： - 限价单时对比委托价与现价 - 委托价偏离市价 5% 以上时提示可能是输入错误 - 市价单时提示滑点（如 5%） ## 错误处理 - "Address required" / "Private key required" → 请在 Decker 设置中绑定 Hyperliquid 密钥 - "Unknown coin" → 请确认 BTC、ETH 等支持的交易对 - 网络错误 → 检查 API 状态与连接 - 禁止自动重试 — 失败后需用户确认再重新请求 ## 参考 - 主 decker 技能：docs/openclaw_skills/decker/SKILL.md` - Hyperliquid：去中心化永续合约 DEX