多 Agent 共享知识库实施方案（OpenClaw）

多 Agent 共享知识库实施方案（OpenClaw）

1. 背景与目标

当前系统采用多 Agent 协作模式，各 Agent 使用独立 workspace（如 workspace、workspace-news、workspace-content、workspace-ops、workspace-xuanti）。

目标是在不打破独立性的前提下，建立统一共享知识库，实现跨 Agent 的知识沉淀与复用。

2. 方案选型

采用：独立 workspace + 共享目录 + 符号链接（symlink）。

• 每个 Agent 继续在自己的 workspace 工作，避免上下文污染。
• 创建公共目录 /root/.openclaw/shared 作为共享知识库。
• 在每个 workspace 下挂载 shared 符号链接，统一指向公共目录。

3. 目录结构

/root/.openclaw/
├── shared/
│   ├── knowledge/
│   ├── assets/
│   └── todo/
├── workspace/
│   └── shared -> /root/.openclaw/shared
├── workspace-news/
│   └── shared -> /root/.openclaw/shared
├── workspace-content/
│   └── shared -> /root/.openclaw/shared
├── workspace-ops/
│   └── shared -> /root/.openclaw/shared
└── workspace-xuanti/
    └── shared -> /root/.openclaw/shared

4. 实施命令

mkdir -p /root/.openclaw/shared/{knowledge,assets,todo}
mkdir -p /root/.openclaw/workspace-xuanti

for ws in workspace workspace-news workspace-content workspace-ops workspace-xuanti; do
  target="/root/.openclaw/$ws/shared"
  if [ ! -e "$target" ]; then
    ln -s /root/.openclaw/shared "$target"
  fi
done

5. 验证方法

5.1 结构验证

ls -la /root/.openclaw/shared/
for ws in workspace workspace-news workspace-content workspace-ops workspace-xuanti; do
  ls -ld "/root/.openclaw/$ws/shared"
done

5.2 联通验证（写入一次，多点可读）

echo "test from verify" > /root/.openclaw/shared/knowledge/.verify_test
for ws in workspace workspace-news workspace-content workspace-ops workspace-xuanti; do
  test -f "/root/.openclaw/$ws/shared/knowledge/.verify_test" && echo "$ws: OK" || echo "$ws: FAIL"
done
rm -f /root/.openclaw/shared/knowledge/.verify_test

6. 使用规范

6.1 目录职责

• shared/knowledge/：公共知识文档、调研结论、流程 SOP。
• shared/assets/：共享图片、附件、素材。
• shared/todo/：跨 Agent 协作任务、交接清单。

6.2 命名建议

建议采用：YYYY-MM-DD-主题-来源.md

示例：2026-03-10-选题策略-行业观察.md

6.3 协作建议

• 先写结论，再补过程，提升可复用性。
• 每篇文档注明来源与更新时间。
• 涉及决策内容，明确“适用范围”和“失效条件”。

7. 标准知识文档模板

---
title: ""
date: "2026-03-10"
owner: ""
agent: ""
status: "draft" # draft|active|archived
tags: []
source: []
updated_at: "2026-03-10"
---

# 一、结论摘要
- 

# 二、背景
- 

# 三、关键信息
- 

# 四、可执行建议
1. 
2. 

# 五、风险与边界
- 

# 六、待跟进
- [ ] 

8. 回滚方案

若需撤销共享机制，仅删除各 workspace 下的 shared 符号链接（不会删除真实共享数据）：

for ws in workspace workspace-news workspace-content workspace-ops workspace-xuanti; do
  rm -f "/root/.openclaw/$ws/shared"
done

如需彻底清理，再按需删除：

rm -rf /root/.openclaw/shared

9. 运维注意事项

• 优先保留“独立 workspace + 共享知识库”的结构，不建议所有 Agent 共用同一 workspace 根目录。

• 对 shared/knowledge/ 建议定期备份。

• 若后续新增 Agent，仅需：

  1. 创建 workspace-<agent> 目录；
  2. 创建 workspace-<agent>/shared -> /root/.openclaw/shared 符号链接。