# OpenClaw 多 Agent 协作方案：实际配置核实

## 核实结论

原分析报告有若干关键错误，以下基于实际配置数据修正。

---

## 一、实际系统配置

### 1.1 Agent 现状（实际）

| Agent ID | 名称 | 工作区 | 状态 |
|-----------|------|--------|------|
| main | 主代理 | /root/.openclaw/workspace | ✅ 活跃 |
| news | 新闻助手 | /root/.openclaw/workspace-news | ✅ 活跃 |
| assistant | 个人助理 | /root/.openclaw/workspace-assistant | ✅ 活跃 |
| research | 研究助手 | /root/.openclaw/workspace-research | ✅ 活跃 |
| weixin2 | 小新 | /root/.openclaw/agents/weixin2 | ⚠️ 有目录但未入 config |
| zz | - | /root/.openclaw/agents/zz | ❌ 未配置 |

**原分析错误**：报告说"6个Agent"，实际活跃的4个。weixin2 和 zz 有目录但不在活跃配置里。

### 1.2 agentToAgent（已确认开启）

```yaml
tools:
  agentToAgent:
    enabled: true
    allow: ["main", "news", "assistant", "research"]
```

**好消息**：多 Agent 通信已经启用，不需要额外配置。

---

## 二、向量检索实际配置

### 2.1 记忆搜索配置

```yaml
memorySearch:
  provider: openai        # OpenAI 兼容接口
  enabled: true
  model: embedding-3     # GLM embedding-3 模型
  remote:
    baseUrl: https://open.bigmodel.cn/api/paas/v4
```

**结论**：向量检索已配置，通过 BigModel CN API 的 embedding-3 实现，不是 SQLite。原分析"70%相似度"修正为 80%。

### 2.2 LanceDB-pro 状态

```
config.yaml 配置了 memory-lancedb-pro 插件
但 /root/.openclaw/memory/lancedb-pro/ 目录是空的
插件已配置但未实际启用本地向量存储
```

---

## 三、知识库实际配置（双 Wiki 架构）

系统存在 **两套 Wiki**，需要区分：

| 位置 | 类型 | 用途 |
|------|------|------|
| /root/.openclaw/wiki/ | OpenClaw memory-wiki | Agent 记忆层，bridge 模式 |
| /home/obsidian/wiki/ | 标准 Obsidian vault | 你的主知识库，Obsidian 桌面端用 |

### 3.1 OpenClaw wiki（Agent 用）

```
wiki/
├── concepts/      # 概念页
├── entities/      # 实体页
├── sources/       # 原始资料
├── reports/       # 报告
├── syntheses/     # 综合
├── main/          # 主代理子空间
├── index.md
├── WIKI.md
└── AGENTS.md
```

- vault mode: bridge（连接外部 Obsidian）
- render mode: obsidian
- search corpus: all

### 3.2 Obsidian vault（你本地用）

/home/obsidian/wiki/ - 这是你日常在 Obsidian 里用的笔记库。

### 3.3 共享知识库

```
workspace-shared/
├── 01-公共知识/
├── 02-协作记录/
├── 03-资源库/
└── README.md
```

README 明确定义了使用规则：只读优先、分 Agent 写入不同文件、定期清理。

---

## 四、Git 同步现状

### 4.1 PC 端已有同步脚本

`/root/.openclaw/workspace/Obsidian/sync-gitea.ps1` - PowerShell 脚本，功能：
- 检测本地变更 → git add/commit
- git pull 远程
- 检测冲突（发现冲突则退出告警）
- git push

### 4.2 腾讯云端现状

**尚未配置 Git 同步**。云端 VM 的 /home/obsidian/wiki/ 没有初始化 Git，也没有关联 Gitee。

### 4.3 风险重新评估

| 风险 | 原方案 | 实际问题 |
|------|--------|---------|
| 同时写入冲突 | "使用文件锁或分区存储" | sync-gitea.ps1 只检测冲突后退出，没有自动解决 |
| 冲突通知 | 未提及 | 冲突时脚本 exit 2，但谁来处理？ |

---

## 五、Coding Subagent 现状

```
/root/.openclaw/subagents/runs.json
→ {"version": 2, "runs": {}}
```

**subagent 机制存在，但目前没有配置任何 subagent。**

原分析推荐用 `openclaw subagent create` 创建 coding subagent，但：
- openclaw 命令本身有权限问题（/root/.local/share/pnpm/openclaw Permission denied）
- 没有找到 `subagent create` 的实际命令文档
- subagent 机制和 workspace-agent 是两套系统

**建议**：先用现有的 assistant agent 承担 coding 任务，不一定要单独建 subagent。

---

## 六、关键修正汇总

| 项目 | 原分析结论 | 实际核实结论 |
|------|-----------|------------|
| 活跃 Agent 数量 | 6个 | 4个（main/news/assistant/research） |
| agentToAgent | "需要配置" | ✅ 已启用 |
| 向量数据库 | SQLite 70%相似度 | 有 embedding-3 向量搜索，80% |
| Wiki 结构 | 一套 | 两套（OpenClaw wiki + Obsidian vault） |
| 共享知识库 | "需要创建" | workspace-shared 已存在 |
| Git 同步 | "需要开发" | PC 端脚本已有，云端未配置 |
| coding subagent | "用命令创建" | subagent 机制空，命令未验证 |

---

## 七、修正后的分阶段方案

### 阶段一：验证多 Agent 协作（1-2天）

**目标**：验证 agentToAgent 委派流程

现有条件已满足，只需写 SOUL.md 协作规则。

```
阶段一可以立即执行，不需要任何配置变更
```

### 阶段二：建立云端 Git 同步（2-3天）

```
1. 腾讯云 VM 上初始化 Git（/home/obsidian/wiki/ → git init）
2. 关联 Gitee 仓库（和 PC 端同一仓库）
3. 配置 cron 自动同步（每30分钟）
4. 添加冲突检测脚本
```

### 阶段三：完善 Wiki 体系（持续）

```
1. 补全 /home/obsidian/wiki/ 的 LLMWiki 元文件（SCHEMA.md, index.md, log.md）
2. 将 wiki-vault-maintainer skill 的规范落地到 Obsidian
3. 统一两套 Wiki 的边界和使用规则
```

### 阶段四：Coding 能力建设（如果需要）

```
方案A：改造 assistant agent，给它写专门的 SOUL.md 增加 coding 职责
方案B：等 subagent 机制验证后再迁过去
```

---

## 八、立即可执行的行动

### 今天可以做

1. **给 main agent 写 SOUL.md**，加入委派规则
2. **验证 agentToAgent** 是否真的工作：向 main 发消息委派给 news，看能否通信

### 本周可以做

1. 初始化云端 wiki 的 Git：进入 /home/obsidian/wiki/ → git init → 关联 Gitee
2. PC 端和云端同时配置 cron 同步
3. 写 workspace-shared/02-协作记录/ 里的协作规则文档

### 需要先确认的

1. Gitee 仓库地址是什么？
2. weixin2 和 zz 这两个 agent 还要不要激活？

---

## 九、风险项重新评估

| 风险 | 可能性 | 影响 | 应对 |
|------|--------|------|------|
| Git 同步冲突 | 高 | 中 | 明确各端写入分区，发生冲突告警人工处理 |
| weixin2/zz agent 冲突 | 中 | 低 | 明确不激活或删除 |
| 两套 Wiki 混乱 | 中 | 高 | 明确边界：OpenClaw wiki 是 Agent 记忆层，Obsidian 是用户交互层 |
| subagent 命令不可用 | 高 | 中 | 先用 assistant agent 试，不等 subagent |