Decker + Hyperliquid (DEX) 技能

目标

通过 Decker 在 Hyperliquid DEX 上执行行情查询和订单操作。扩展主 Decker 技能。

快速参考

DECKERAPIURL

https://api.decker-ai.com

下单 (Hyperliquid)

在 order-request 中添加 exchange_id=hyperliquid：

GET {DECKERAPIURL}/api/v1/link/slack/order-request?slackuserid={senderid}&symbol=BTC&side=buy&quantity=0.01&exchangeid=hyperliquid&openclawsecret={OPENCLAWSECRET}

• - exchange_id=hyperliquid 必填 (执行 Hyperliquid DEX 交易)
• symbol: BTC、ETH 等 (自动使用 USDT 永续合约)
• quantity: 合约数量

前提条件

• - 注册 Decker 并关联 Slack
• usersettings.exchangepreference = hyperliquid 或在下单时指定 exchange_id
• 关联 Hyperliquid 密钥 (Decker 设置 → 交易所 API 设置)

Hyperliquid 密钥设置 (供代理参考)

1. 1. 创建 API 专用钱包: 访问 https://app.hyperliquid.xyz/API → Create API Wallet
2. 备份私钥: 安全保存创建时显示的私钥 (以 0x 开头) (仅显示一次)
3. Decker 设置: 登录 → 设置 → 交易所 API 设置 → Hyperliquid

1. 4. 选择交易所: 将 exchange_preference 设置为 Hyperliquid 后保存
2. 下单: 帮我买入 HL BTC 0.01 (Slack/Telegram)

⚠️ API 钱包仅限交易使用，不可提现。建议与主钱包分离。

安全指南 (整合 ClawHub hyperliquid-trading)

下单执行前:

1. 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