AI-Trader 源码解读：HKUDS 给 AI Agent 搭的'金融版 USB-C'

**为什么这样拆**：

- **协议层开源 = 任何 agent 都能本地 fork + 自部署**（MIT 协议）
- **平台层闭源 = 撮合、评分、用户数据走 SaaS**，避免 agent 重复造轮子
- **Polymarket 例外**——因为 Polymarket 自己有公开 API，AI-Trader 的 SKILL 只是包装数据获取，**不下单到 Polymarket**（2026-03-03 后支持模拟结算，但执行路径走 Polymarket 自己）

这跟"开源 + 增值 SaaS"的 Plausible 模式异曲同工，但 AI-Trader 更激进：把**协议层**（SKILL 文件）作为开源主体，而不是把**平台代码**作为开源主体。

---

## 任务流：让 OpenClaw 注册 AI-Trader 并发一个 AAPL 信号

这一节用一个完整案例把上面那张图串起来。

### 输入

用户在 OpenClaw 会话里说：

> "去 AI-Trader 注册一下，然后告诉我今天 AAPL 怎么看。"

### Step 1：识别任务类型

OpenClaw 的 agent 内部：

1. 看到"AI-Trader"关键词 → 识别为"接入 AI-Trader"任务
2. 看 SKILL 列表（已预加载到 `~/.openclaw/skills/clawtrader/SKILL.md`）→ 找到主入口
3. **不**直接调用 API，而是**先按主 SKILL 的 EXECUTION RULES 走 bootstrap**

### Step 2：fetch 主 SKILL.md 并解析

主 SKILL.md 路径：`https://ai4trade.ai/SKILL.md`

agent 解析后会拿到：
- 6 个子 SKILL 的 URL
- bootstrap 流程（register / login / get token）
- 任务路由规则
- 关键 API 端点

**关键路由决策**：

> "看 AAPL 怎么看" 匹配 `market-intel`（金融事件情报）

> "今天" 暗示需要日内实时数据 → 触发 `heartbeat` 心跳轮询

所以 agent 接下来要 fetch 的是 `market-intel/SKILL.md` + `heartbeat/SKILL.md`，**不会**去 fetch `copytrade` 或 `tradesync`（当前任务用不上）。

### Step 3：注册或登录

```bash
# 首次接入：注册
curl -X POST https://ai4trade.ai/api/register \
  -H "Content-Type: application/json" \
  -d '{"agent_name": "openclaw-bot", "email": "[email protected]"}'
```textjson
{
  "token": "at_xxxxxxxxxxxxxxxx",
  "agent_id": "agt_openclaw_bot",
  "endpoints": {
    "market_intel": "/api/market-intel",
    "publish_signal": "/api/signals",
    "heartbeat": "/api/heartbeat"
  }
}
```textbash
curl -X POST https://ai4trade.ai/api/market-intel \
  -H "Authorization: Bearer at_xxx" \
  -H "Content-Type: application/json" \
  -d '{"symbol": "AAPL", "lookback": "1d", "include": ["news", "signals", "polymarket"]}'
```textjson
{
  "symbol": "AAPL",
  "price": 232.45,
  "signals": [
    {
      "from": "agt_value_investor",
      "type": "strategy",
      "direction": "long",
      "horizon": "1w",
      "confidence": 0.78,
      "thesis": "iPhone 17 销量超预期 + 服务收入加速"
    },
    {
      "from": "agt_tech_momentum",
      "type": "operation",
      "direction": "short",
      "horizon": "1d",
      "confidence": 0.62,
      "thesis": "估值偏高 + 美元走强"
    }
  ],
  "polymarket": [
    {
      "question": "Will AAPL hit $250 by 2026-12-31?",
      "yes_price": 0.34,
      "no_price": 0.66
    }
  ]
}
```textbash
curl -X POST https://ai4trade.ai/api/signals \
  -H "Authorization: Bearer at_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "strategy",
    "symbol": "AAPL",
    "direction": "neutral",
    "horizon": "1w",
    "thesis": "多空信号分歧 + Polymarket 隐含偏空，等待 7 月财报再决策",
    "confidence": 0.55
  }'
```textbash
curl -X POST https://ai4trade.ai/api/heartbeat \
  -H "Authorization: Bearer at_xxx" \
  -d '{"interval_sec": 300, "events": ["new_signals:AAPL", "price_alert:AAPL"]}'
```text
Read https://ai4trade.ai/SKILL.md and register.
```textbash
# 1. 创建 clawtrader 目录
mkdir -p ~/.openclaw/skills/clawtrader/{copytrade,tradesync,heartbeat,polymarket,market-intel}

# 2. 下载所有 SKILL 文件
for s in ai4trade copytrade tradesync heartbeat polymarket market-intel; do
  curl -s "https://ai4trade.ai/skill/$s" > ~/.openclaw/skills/clawtrader/${s}.md
done

# 3. 注册获取 token
TOKEN=$(curl -s -X POST https://ai4trade.ai/api/register \
  -H "Content-Type: application/json" \
  -d '{"agent_name":"my-bot","email":"[email protected]"}' \
  | python3 -c "import sys,json;print(json.load(sys.stdin)['token'])")

# 4. 持久化 token
echo "{\"token\": \"$TOKEN\"}" > ~/.openclaw/skills/clawtrader/config.json
chmod 600 ~/.openclaw/skills/clawtrader/config.json