llm_wiki/tools/docs/homewiki/多Agent协作-OpenClaw实际配置核实报告.md

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（已确认开启）

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

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

---

二、向量检索实际配置

2.1 记忆搜索配置

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