---
created: "2026-03-21"
type: resource
status: active
tags: [trading, multi-agent, openclaw, openbb, guide, investment]
---

# Trading Agents 使用指南

如何使用投资分析 Agent 系统和 OpenBB Invest API 进行专业级投资分析。

---

## 一、系统架构总览

```
         你 (Discord Stock Guild)
              │
              ▼
     ┌─────────────────┐
     │ invest-analyst   │  ← 编排者 + 最终裁判
     │ (stock bot)      │     唯一对外输出的 agent
     └────────┬────────┘
              │ sessions_spawn
     ┌────────┼────────────────┐
     ▼        ▼        ▼       ▼
  ┌──────┐ ┌──────┐ ┌──────┐ ┌──────┐
  │ Bull │ │ Bear │ │ Hawk │ │ Dove │
  │ 🐂   │ │ 🐻   │ │ 🦅   │ │ 🕊️   │
  └──────┘ └──────┘ └──────┘ └──────┘
  后台运行   后台运行   后台运行   后台运行
  (无Discord输出)

  数据来源：openbb-invest-api (K8s: invest-api.k8s.home)
            132+ 端点（Skills 覆盖 79%）, 覆盖技术/基本面/情感/宏观/量化
```

### Agent 角色

| Agent | 身份 | 职责 | Discord |
|-------|------|------|---------|
| **invest-analyst** | 编排者/裁判 | 接收用户指令，收集数据，调度辩论，输出最终裁决 | ✅ 在线，响应用户 |
| **invest-bull** | 多方研究员 | 构建看多论点，引用数据支持上行空间 | ❌ 后台 |
| **invest-bear** | 空方研究员 | 构建看空论点，揭示风险和高估 | ❌ 后台 |
| **invest-hawk** | 激进风控 | 大仓位、紧止损、追求超额收益 | ❌ 后台 |
| **invest-dove** | 保守风控 | 小仓位、分批建仓、保护本金 | ❌ 后台 |

### 通信协议

- **用户 → invest-analyst**：Discord 消息（Stock Guild #general）
- **invest-analyst → 辩论 agent**：`sessions_spawn`（后台，非阻塞）
- **辩论 agent → invest-analyst**：自动 announce（结果推送回来）
- **辩论 agent → Discord**：❌ 不输出（Discord 已禁用）

---

## 二、可用的 Skill（7 个）

### 分析类 Skill

| Skill | 触发方式 | 用途 | 端点数 |
|-------|---------|------|--------|
| **trade-analyze** | `/trade-analyze {TICKER}` | 完整辩论分析 → BUY/SELL/HOLD | 8 |
| **market-analysis** | `/market-analysis {TICKER}` | 技术面分析（14种指标） | 15 |
| **fundamental-analysis** | `/fundamental-analysis {TICKER}` | 基本面+量化风险 | 16 |
| **sentiment-analysis** | `/sentiment-analysis {TICKER}` | 情感+smart money | 16 |
| **macro-analysis** | `/macro-analysis {TICKER}` | 宏观环境+利率+衰退指标 | 23 |

### 组合类 Skill

| Skill | 触发方式 | 用途 | 端点数 |
|-------|---------|------|--------|
| **portfolio-review** | `/portfolio-review` | 组合优化+相关性+聚类 | 6+ |
| **strategy-backtest** | `/strategy-backtest {TICKER}` | 策略回测验证 | 4 |

### 通用 Skill

| Skill | 用途 |
|-------|------|
| **invest-api** | 直接调用任何 API 端点（132+），用于快速查询 |

---

## 三、使用场景

### 场景 1：快速查询（直接回答，不触发辩论）

```
帮我看看 AAPL 现在什么价格
NVDA 的 RSI 多少
最近有什么股票在涨
下周有哪些公司发财报
美国 CPI 最新数据
```

invest-analyst 直接用 invest-api skill 回答，不调用辩论 agent。

### 场景 2：深度辩论分析

```
/trade-analyze NVDA
帮我深度分析一下 AMZN 要不要买
全面分析 TSLA
```

完整流程：
1. invest-analyst 收集 8 类数据（summary, technical, sentiment, macro, upgrades, shorts, CAPM, Sortino）
2. spawn invest-bull → 构建 Bull Case（等待 announce）
3. spawn invest-bear → 反驳 Bull（等待 announce）
4. spawn invest-bull → 最终反驳 Bear（等待 announce）
5. spawn invest-hawk → 激进风控评估（等待 announce）
6. spawn invest-dove → 保守风控评估（等待 announce）
7. invest-analyst 综合裁决 → 输出 Trading Verdict

**输出**：一份完整的 Trading Verdict，包含 BUY/SELL/HOLD 决策、入场计划、Bull/Bear 核心论点、Hawk/Dove 风控建议。

### 场景 3：单维度深入分析

```
/market-analysis NVDA     ← 只看技术面（14种指标全开）
/fundamental-analysis NVDA ← 只看基本面+量化风险
/sentiment-analysis NVDA   ← 只看情感+smart money
/macro-analysis NVDA       ← 只看宏观环境
```

不触发辩论，直接生成结构化报告。

### 场景 4：投资组合管理

```
/portfolio-review          ← 分析我的持仓（从 MEMORY.md 读取）
帮我看看我的组合怎么优化
AAPL 和 MSFT 相关性高吗
帮我找和 NVDA 类似的股票
```

使用 HRP 优化、相关性矩阵、t-SNE 聚类、相似度搜索。

### 场景 5：策略回测验证

```
/strategy-backtest NVDA    ← 回测 SMA 交叉 + RSI + 买入持有
如果我用 RSI 策略买 AAPL 一年回报怎么样
```

对比 3 种策略 vs 买入持有基准，输出 Sharpe、最大回撤、胜率。

---

## 四、OpenBB Invest API 端点速查

### 个股分析（用 symbol 查询）

| 类别 | 关键端点 | 专业用法 |
|------|---------|---------|
| **行情** | `/stock/{s}/summary` | 一次拿到 quote+profile+metrics+financials |
| **技术** | `/stock/{s}/technical` | 复合指标 + 14 种独立指标 |
| **风险** | `/stock/{s}/capm` | Alpha = 超额收益，Beta = 市场敏感度 |
| **风险** | `/stock/{s}/sortino` | 下行风险（比 Sharpe 更好） |
| **风险** | `/stock/{s}/normality` | 正态性检验 → 决定用 Sharpe 还是 Omega |
| **风险** | `/stock/{s}/rolling/skew` | 负偏度 = 崩盘风险上升 |
| **情感** | `/stock/{s}/sentiment` | 多源复合评分 |
| **内幕** | `/stock/{s}/insider-trades` | CEO 买 = 强信号 |
| **做空** | `/stock/{s}/shorts/interest` | Days to cover > 5 = 潜在挤空 |
| **暗池** | `/darkpool/{s}/otc` | 机构大宗交易活动 |

### 宏观分析（全市场视角）

| 类别 | 关键端点 | 专业用法 |
|------|---------|---------|
| **利率** | `/fixed-income/yield-curve` | 倒挂 = 最强衰退预警 |
| **利率** | `/fixed-income/spreads` | 信用利差扩大 = 市场压力 |
| **通胀** | `/macro/pce` | Fed 偏好指标，比 CPI 更重要 |
| **衰退** | `/economy/surveys/sloos` | 最强衰退领先指标（6-12月提前） |
| **衰退** | `/macro/cli` | < 100 且下降 = 衰退警告 |
| **恐慌** | `/macro/overview` → VIX | > 30 = 恐慌（反向买入信号） |
| **估值** | `/index/sp500-multiples` | 历史 PE 对比判断市场贵不贵 |

### 量化风险指标使用指南

```
Sharpe > 1.0     → 好（风险调整后正收益）
Sortino > Sharpe → 好（正偏度，上行多于下行）
Omega > 1.0      → 好（收益概率 > 损失概率）

Normality p < 0.05 → 非正态 → Sharpe/VaR 不可靠，用 Sortino/Omega
Unit Root p < 0.05 → 有趋势 → 技术分析有效
Unit Root p > 0.05 → 随机游走 → 别信技术指标

Rolling Skew < 0 且下降 → 崩盘风险上升 → 减仓
Rolling Kurtosis > 3 且上升 → 极端事件概率增加 → 加宽止损
```

### 组合与回测

| 类别 | 关键端点 | 专业用法 |
|------|---------|---------|
| **优化** | `/portfolio/optimize` | HRP 权重（比等权更好的风险调整） |
| **风险** | `/portfolio/risk-parity` | 每个持仓贡献相等风险 |
| **相关性** | `/portfolio/correlation` | > 0.8 = 冗余，< 0.2 = 好的分散 |
| **聚类** | `/portfolio/cluster` | 发现隐藏的相关性（同一类型的股票） |
| **回测** | `/backtest/sma-crossover` | 趋势跟踪策略验证 |
| **回测** | `/backtest/rsi` | 均值回归策略验证 |
| **回测** | `/backtest/momentum` | 多股轮动策略验证 |

---

## 五、辩论流程编排细节

### sessions_spawn 调用链

```
invest-analyst
  │
  ├─ spawn invest-bull (task: "build bull case with data: ...")
  │   └─ announce → invest-analyst 收到 Bull 论点
  │
  ├─ spawn invest-bear (task: "counter Bull: {Bull论点}, data: ...")
  │   └─ announce → invest-analyst 收到 Bear 论点
  │
  ├─ spawn invest-bull (task: "final rebuttal to Bear: {Bear论点}")
  │   └─ announce → invest-analyst 收到 Bull 最终反驳
  │
  ├─ spawn invest-hawk (task: "aggressive risk for proposal: {方案}")
  │   └─ announce → invest-analyst 收到 Hawk 评估
  │
  ├─ spawn invest-dove (task: "conservative risk, Hawk said: {Hawk评估}")
  │   └─ announce → invest-analyst 收到 Dove 评估
  │
  └─ 综合 5 个 announce → 输出最终 Trading Verdict
```

### 关键约束

- **最多 5 次 spawn**：Bull(2) + Bear(1) + Hawk(1) + Dove(1)
- **顺序执行**：等待每个 announce 后才 spawn 下一个
- **超时处理**：spawn 超时 → 跳过，降低置信度
- **单一输出**：只有 invest-analyst 发到 Discord

### 为什么不用 sessions_send

| 问题 | sessions_send | sessions_spawn |
|------|--------------|----------------|
| Gateway 死锁 | ❌ 同进程内自连超时 | ✅ 独立 lane |
| 轮次控制 | ⚠️ 需要 REPLY_SKIP | ✅ 一次性任务 |
| Discord 输出 | ⚠️ 可能泄露到频道 | ✅ 完全后台 |

详见 [[Trading Agents 调试与优化记录]] 的 Gateway WebSocket 修复章节。

---

## 六、日常使用 Tips

### 快速决策流程

```
1. 先快速查看：帮我看看 NVDA 现在怎么样
2. 如果感兴趣：/trade-analyze NVDA（完整辩论）
3. 验证决策：/strategy-backtest NVDA（回测确认）
4. 检查组合影响：/portfolio-review（看相关性和权重）
```

### 每日简报（自动）

invest-analyst 有 cron 任务，工作日 08:00 自动生成：
- 组合 P&L 摘要
- 宏观概览（Fed rate, VIX, S&P 500）
- 持仓新闻和情感变化
- 即将到来的财报
- BUY/SELL 信号

### 记忆系统

invest-analyst 会记住：
- 你的持仓（MEMORY.md）
- 每次分析的决策（memory/YYYY-MM-DD.md）
- 历史建议和胜率

告诉它更新持仓：
```
我买了 50 股 NVDA，成本 $170
我卖掉了 AAPL 的全部持仓
```

---

## 七、Skill 更新与维护

### 更新单个 Skill

1. 在本地 `openbb-invest-api/openclaw-skills/` 修改 SKILL.md
2. 运行部署脚本：
```bash
cd /Users/yiukai/Documents/git/openbb-invest-api
./openclaw-skills/deploy.sh
```

### 手动部署单个文件

```bash
scp openclaw-skills/trade-analyze/SKILL.md yiukai@192.168.68.108:~/.openclaw/workspace-invest-analyst/skills/trade-analyze/SKILL.md
```

### 重启 Gateway（应用新 skill）

```bash
ssh yiukai@192.168.68.108 'export NVM_DIR="$HOME/.nvm"; [ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"; openclaw gateway restart'
```

### ⚠️ npm update 后需要重新打 patch

OpenClaw v2026.3.13 有 WebSocket bug，已打 3 个 patch。`npm update openclaw` 后会被覆盖。详见 [[Trading Agents 调试与优化记录]] 第六节。

---

## Related

- [[Trading Agents 混合架构方案]]
- [[Trading Agents 部署记录]]
- [[Trading Agents 调试与优化记录]]
- [[TradingAgents 原始架构分析]]
- [[OpenClaw 部署配置分析]]
