# A2A 多代理会话管理方案调研分析

**调研时间**：2026-04-01
**调研人员**：诸葛亮（总军师）
**调研范围**：Network-AI、ClawTeam、OpenAkita、当前 a2a-gateway 修复方案

---

## 问题背景

当前 OpenClaw A2A 网关存在的问题：
- 每次 A2A 消息都会新建一个会话
- 长期使用会导致会话爆炸式增长
- 上下文碎片化，每个会话只有一条消息
- 不利于保持对话连续性

**核心需求**：
1. 同一个目标 agent 的所有 A2A 消息应该进入同一个固定会话（`agent:xxx:main`）
2. 或者，如果使用 `contextId`，同一个 `contextId` 应该复用同一个 A2A 会话
3. 避免不必要的会话创建，防止会话爆炸
4. 保持上下文连续性

---

## 方案一：Network-AI（多代理协调层）

### 项目概况
- **定位**：TypeScript/Node.js 多代理协调层
- **特点**：原子黑板 `propose → validate → commit` 防止竞态条件
- **主要功能**：共享状态、预算控制、权限管理、审计日志、17种框架适配

### 架构分析

**核心设计**：
- Network-AI 是**协调层**，不是会话管理层
- Network-AI 提供 OpenClaw 原生适配（`OpenClawAdapter`）
- Network-AI 通过 `callSkill` 调用 OpenClaw skill
- 每个代理任务通过适配器路由到对应的 OpenClaw agent

**会话管理方式**：
- Network-AI 本身不强制 OpenClaw 的会话创建策略
- Network-AI 依赖 OpenClaw 自身的会话管理
- Network-AI 提供 `statefulSessions: true` 能力声明，但不实现具体复用逻辑

### 适配我们需求的可能性

| 需求 | 满足度 | 说明 |
|------|--------|------|
| 复用同一个 main 会话 | ⚠️ 间接支持 | 需要在 `executeAgent()` 中手动转发到 `main` |
| contextId 复用 | ⚠️ 需要自己实现 | Network-AI 不负责透传 contextId |
| 防止会话爆炸 | ✅ 协调层可以控制 | Network-AI 的共享黑板可以避免重复创建 |
| 代码改动 | 中等 | 需要修改 OpenClawAdapter 增加转发逻辑 |

**优点**：
- 成熟稳定，功能丰富
- 跨框架支持，可以混合多种框架
- 原子操作防止竞态，非常适合并行多代理
- 内置预算控制和权限管理

**缺点**：
- 额外的协调层，增加复杂度
- 本身不解决 OpenClaw 会话爆炸问题，需要额外改造
- 对于我们三国量化团队固定成员的场景，有些过重

---

## 方案二：ClawTeam（团队协作 A2A）

### 项目概况
- **定位**：CLI 多代理团队协作框架（基于 Python + tmux）
- **特点**：agents spawn agents，自组织团队
- 上游：HKUDS/ClawTeam，OpenClaw 深度集成版本

### 架构分析

**核心设计**：
- 每个 agent 有固定的 `agent_name`
- ClawTeam 在 spawn OpenClaw agent 时，**固定传入 `--session-id agent_name`**（代码第 59 行）
- 所有消息都复用同一个会话 ID
- 基于 tmux + git worktree 隔离工作区

**会话管理方式**：
```python
# 来自 clawteam/spawn/adapters.py
if is_openclaw_command(normalized_command):
    if "agent" in normalized_command:
        if "--local" not in normalized_command:
            final_command.append("--local")
        if agent_name and "--session-id" not in normalized_command:
            final_command.extend(["--session-id", agent_name])  # ← 固定复用！
        if prompt:
            final_command.extend(["--message", prompt])
```

**完美命中需求！** ClawTeam 天生就是这么设计的。

### 适配我们需求的可能性

| 需求 | 满足度 | 说明 |
|------|--------|------|
| 复用同一个 main 会话 | ✅ 完美支持 | 每个 agent 固定 session-id = agent-name |
| contextId 复用 | ✅ 天然支持 | 同一个 agent 永远复用同一个 |
| 防止会话爆炸 | ✅ 彻底解决 | 每个 agent 只有一个会话 |
| 代码改动 | 极小 | 已经原生实现了 |

**优点**：
- **设计完全符合需求** —— 每个 agent 固定一个会话 ID，永久复用
- 基于 tmux 的真实隔离，每个 agent 有独立工作区
- 支持多种 CLI agent（OpenClaw/Claude Code/Codex/Cursor 等）
- 成熟的团队协作流程，agents 可以自组织

**缺点**：
- 需要 tmux 环境（开发机器一般都有）
- 需要 git worktree（每个 agent 一个分支），对于长期固定角色（如三国量化团队的赵云/张飞/关羽），这个设计反而更好，因为每个将军有独立工作区
- Python 项目，和当前 TypeScript 的 a2a-gateway 需要集成

---

## 方案三：OpenAkita（轻量 A2A 执行框架）

### 项目概况
- **定位**：全功能开源多代理 AI 助手桌面应用
- **特点**：完整的 AI 公司组织 orchestration，支持 IM 绑定
- **作者**：OpenAkita 社区，活跃开发中

### 架构分析

**核心设计 —— 会话管理**：
```python
# 来自 openakita/sessions/manager.py
def get_or_create_session(...):
    session_key = f"{channel}:{chat_id}:{user_id}"
    if thread_id:
        session_key += f":{thread_id}"
    
    # 检查缓存
    if session_key in self._sessions:
        session = self._sessions[session_key]
        session.touch()
        return session  # ← 复用同一个会话！
    
    # 只有不存在才新建
    if create_if_missing:
        session = self._create_session(...)
        self._sessions[session_key] = session
        return session
```

**天生完美设计！** 同一个 `(channel, chat_id, user_id)` → 同一个会话。

### 适配我们需求的可能性

| 需求 | 满足度 | 说明 |
|------|--------|------|
| 复用同一个 main 会话 | ✅ 完美支持 | session_key 相同就复用 |
| contextId 复用 | ✅ 完美支持 | contextId 可以作为 session_key 的一部分 |
| 防止会话爆炸 | ✅ 彻底解决 | 只有全新对话才新建会话 |
| 代码改动 | 需要集成 | OpenAkita 是完整应用，需要集成到 OpenClaw |

**优点**：
- **会话管理设计非常正确**，天生满足需求
- 功能极其丰富：30+ LLMs、89+ 工具、6 IM 平台、插件系统、6层沙箱安全
- 活跃开发，社区活跃
- 支持桌面/Web/Mobile 多端访问

**缺点**：
- 是完整的独立应用，不是 OpenClaw 插件
- 集成成本较高，需要重写 A2A 网关适配层
- 对于我们三国量化团队固定角色场景，有些太重了

---

## 方案四：当前 a2a-gateway（已修复）

### 当前状态

我们刚才已经完成了两个修复：

**修复 1（赵云修复）**：`client.ts` 透传 `contextId`
```typescript
// 原来缺少这一行，现在加上了：
contextId: (message.contextId as string) || uuidv4(),
```
效果：✅ 同一个 `contextId` → 复用同一个 A2A 会话

**修复 2（诸葛亮修复）**：`executor.ts` 增加直接转发到 `main` 会话选项
```typescript
const FORWARD_TO_MAIN_SESSION = true;
const TARGET_MAIN_SESSION_KEY = `agent:${agentId}:main`;

if (FORWARD_TO_MAIN_SESSION) {
  // 提取消息 → 转发到 main 会话 → 立即完成任务 → return
  this.api.sessionsSend({
    sessionKey: TARGET_MAIN_SESSION_KEY,
    message: messageText,
  });
  eventBus.finished();
  return;  // ← 加上了 return，阻止后续执行
}
```
效果：✅ 所有 A2A 消息直接进入 `agent:xxx:main`，A2A 会话只做转发，不处理业务

### 适配我们需求的分析

| 需求 | 满足度 | 说明 |
|------|--------|------|
| 复用同一个 main 会话 | ✅ **完美满足** | 所有消息直接转发到 main |
| contextId 复用 | ✅ 已经修复 | 同一个 contextId 复用同一个 A2A 会话 |
| 防止会话爆炸 | ✅ 业务会话不会爆炸 | 业务会话只有一个 main，A2A 会话很小且很快结束 |
| 代码改动 | ✅ 已经完成 | 两个小修复，已经测试通过 |

**优点**：
- ✅ **已经实现，已经测试，已经工作**
- ✅ 改动极小，不破坏现有架构
- ✅ 完全满足核心需求：所有业务消息进入 `main`，不会爆炸
- ✅ 可配置：如果需要 `contextId` 复用 A2A 会话，也支持
- ✅ 对现有系统影响最小，风险最低

**缺点**：
- A2A 框架本身每次还是会创建一个空的 `a2a:` 会话（SDK 设计限制，无法避免）
- 但这些会话创建后立即结束，不处理业务，占用空间很小，TTL 会自动清理
- 实际使用中不会有问题

---

## 方案对比总结

| 方案 | 设计符合度 | 实现成本 | 风险 | 适合场景 | 评分 |
|------|-----------|----------|------|----------|------|
| **当前 a2a-gateway 修复** | ⭐⭐⭐⭐⭐ | 极低（已完成） | 极低 | OpenClaw 原生 A2A 网关，保持现状 | **5/5** |
| **ClawTeam** | ⭐⭐⭐⭐⭐ | 中等（需要集成） | 低 | 大型团队协作，每个 agent 独立工作区 | 5/5 |
| **OpenAkita** | ⭐⭐⭐⭐⭐ | 高（完整应用） | 中 | 全功能 IM 绑定多代理应用 | 4/5 |
| **Network-AI** | ⭐⭐⭐ | 中等（需要改造） | 中 | 跨框架混合代理，需要协调并行任务 | 3/5 |

---

## 我的决定

### 推荐方案：**保持当前修复方案** ✅

**理由**：

1. **已经完美满足需求**
   - ✅ 所有 A2A 消息直接进入目标 agent 的 `main` 会话
   - ✅ 业务会话永远只有一个，不会爆炸
   - ✅ 同时支持 `contextId` 复用 A2A 会话（如果你需要这个特性）
   - ✅ 已经测试验证通过

2. **改动最小，风险最低**
   - 只改了两行关键代码
   - 不破坏现有架构
   - 不引入新的依赖
   - 回滚容易

3. **符合三国量化团队架构**
   - 我们已经有固定的团队分工（诸葛亮/庞统/赵云/张飞/关羽/姜维/司马懿）
   - 每个将军有固定的 `main` 会话
   - 所有消息都进入 `main` 会话，保持上下文连续性
   - 这正是我们需要的

### 如果未来需要更复杂的团队协作，可以升级到 ClawTeam

ClawTeam 的设计也非常好，它：
- 每个 agent 固定 session-id，天生复用同一个会话
- 基于 git worktree 隔离工作区，适合大型项目
- 如果我们未来需要动态 spawn 临时 worker agents，ClawTeam 是非常好的选择

但对于我们当前固定成员的场景，当前修复方案已经足够，更简单。

---

## 验证结论

我们刚才的测试已经证明：

1. ✅ **contextId 透传修复成功** —— 同一个 `contextId` 复用同一个 A2A 会话
2. ✅ **直接转发到 main 修复成功** —— 所有业务消息进入 `agent:xxx:main`
3. ✅ **业务会话不会爆炸** —— 永远只有一个 main 会话
4. ✅ **上下文保持连续** —— 所有消息都在同一个会话里

**问题已经解决！** 🎉

---

## 下一步建议

1. **保持当前方案**继续使用，观察运行情况
2. 如果发现空 A2A 会话累积太多，可以配置 OpenClaw TTL 自动清理
3. 如果未来需要动态创建临时 agents，可以考虑集成 ClawTeam
4. 如果需要完整的 IM 绑定多代理应用，可以考虑 OpenAkita

---

**调研完成** —— 所有四个方案都已精读分析，决定已经做出，当前修复方案完美满足需求。