Web3 Trader Skill

Zero Custody · AI Agent Native · Multi-Wallet · Cyberpunk UI

由 Antalpha AI 提供聚合交易支持

两种运行模式

MCP 远程模式（v1.0.1 新增）

MCP Server 地址

https://mcp-skills.ai.antalpha.com/mcp

可用 MCP Tools

Agent 工作流（MCP 模式，推荐）

用户: "帮我把 0.1 ETH 换成 USDT"
      │
      ▼
┌─ Agent 调用 MCP swap-full ─────────────────┐
│  sell_token=ETH, buy_token=USDT,            │
│  sell_amount=0.1, taker=0xUserWallet        │
│  → 返回 quote + preview_url + tx           │
└────────────┬───────────────────────────────┘
             │  (单次调用，服务端完成报价+页面生成+托管)
             ▼
┌─ Agent 发送消息给用户 ─────────────────────┐
│  交易预览 + preview_url 链接               │
│  🤖 由 Antalpha AI 提供聚合交易支持         │
└────────────┬───────────────────────────────┘
             │
             ▼
┌─ 用户点链接 ───────────────────────────────┐
│  打开 Antalpha 托管页 → 选择钱包            │
│  → 钱包内自动弹出签名 → 交易上链            │
└────────────────────────────────────────────┘

相比 v1.0.0 的改进：

• 5 步 → 1 次 MCP 调用 + 1 次消息发送
• 无需本地生成 HTML / 上传到 Litterbox / 生成 QR 码
• Swap 页面托管在 mcp-skills.ai.antalpha.com 可信域名下
• Agent 无需配置 0x API Key（服务端统一管理）

swap-full 调用示例

{
  "tool": "swap-full",
  "arguments": {
    "sell_token": "ETH",
    "buy_token": "USDT",
    "sell_amount": "0.1",
    "taker": "0x81f9c401B0821B6E0a16BC7B1dF0F647F36211Dd"
  }
}

返回：

{
  "quote": {
    "sell_token": "ETH",
    "buy_token": "USDT",
    "sell_amount": "0.1",
    "buy_amount": "198.12",
    "min_buy_amount": "196.14",
    "price": "1981.22",
    "route": [{"source": "Blackhole_CL", "proportion": "100.0%"}]
  },
  "swap_page": {
    "preview_url": "https://mcp-skills.ai.antalpha.com/web3-trader/preview/<id>",
    "wallets_supported": ["MetaMask", "OKX Web3", "Trust Wallet", "TokenPocket"]
  },
  "tx": { "to": "0x000...734", "value": "100000000000000000", "data": "0x..." }
}

Agent 行为规则

1. 不说废话 — 不输出任何过程性旁白（如"上下文恢复完毕"、"先读 SKILL.md"、"MCP 远程模式调用中"等）。用户只需要看到交易预览结果。
2. 生成 QR 码 — 拿到 preview_url 后，用 qrcode 库生成 QR 码 PNG 图片，作为附件发送给用户，方便手机扫码。
3. 一条消息搞定 — 交易预览文字 + QR 码图片在同一条消息中发出。

QR 码生成流程

import qrcode
qr = qrcode.QRCode(box_size=10, border=3)
qr.add_data(preview_url)  # 从 swap-full 返回值获取
qr.make(fit=True)
img = qr.make_image(fill_color='#00ffaa', back_color='#0a0e14')
img.save('/tmp/swap_qr.png')

生成后将 QR 码图片复制到 ~/.openclaw/workspace/ 发送，发送后删除临时文件。

消息模板（MCP 模式）

⚡ <FROM> → <TO> Swap 交易预览