hehaiguang1123
a6f05ab2d5
- Phase 0: AGENTS.md cleanup (dedup quotes, renumber sections, merge qmd) - Phase 1: typed relations (manage-relations.py, graph-search.py, check-staleness.py, detect-conflicts.py) - Phase 2: frontmatter validator, weekly lint, knowledge promotion, git hooks - Fix .gitignore to track tools/ and .githooks/ - Fix git remote URL (remove plaintext token) - New wiki pages: 504 pages, 34 raw sources
229 lines
6.5 KiB
Markdown
229 lines
6.5 KiB
Markdown
# 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 |
|