多Agent记忆系统

Other

通用多Agent记忆系统 - 自动捕获、RRF检索、知识图谱、矛盾检测、Token追踪

Install

openclaw skills install light-office-multi-agent-memory

多Agent记忆系统 🧠

功能: 通用多Agent记忆系统,支持自动捕获、RRF检索、知识图谱、矛盾检测、Token追踪

适用场景:

  • 单Agent记忆管理
  • 多Agent协作记忆
  • 企业级记忆系统

核心特性:

  • ✅ 8个Hook自动捕获
  • ✅ RRF融合检索(BM25 + Vector + Graph)
  • ✅ 知识图谱构建
  • ✅ 矛盾检测集成(95.7%解决率)
  • ✅ Token消耗追踪
  • ✅ 检索基准测试(R@5=100%)
  • ✅ Git快照管理
  • ✅ 工作流引擎
  • ✅ 实时可视化面板
  • ✅ RRF权重优化
  • 动态Agent管理(自动增加/减少)

快速开始

1. 安装

# 使用ClawHub安装
clawhub install multi-agent-memory

# 或手动安装
npx clawhub@latest install multi-agent-memory

2. 配置

# 运行配置向导
python3 ~/.openclaw/workspace/skills/multi-agent-memory/scripts/setup.py

3. 使用

# 运行集成测试
python3 ~/.openclaw/workspace/skills/multi-agent-memory/scripts/memory-system.py

# 查看可视化面板
open ~/.openclaw/workspace/skills/multi-agent-memory/public/dashboard.html

核心功能

1. Hook自动捕获

python3 ~/.openclaw/workspace/skills/multi-agent-memory/scripts/hook-capture.py

2. RRF融合检索

python3 ~/.openclaw/workspace/skills/multi-agent-memory/scripts/rrf-search.py

3. 知识图谱构建

python3 ~/.openclaw/workspace/skills/multi-agent-memory/scripts/graph-builder.py

4. 矛盾检测集成

python3 ~/.openclaw/workspace/skills/multi-agent-memory/scripts/conflict-detector.py

5. Token消耗追踪

python3 ~/.openclaw/workspace/skills/multi-agent-memory/scripts/token-tracker.py

6. 动态Agent管理

# 注册Agent
python3 ~/.openclaw/workspace/skills/multi-agent-memory/scripts/agent-manager.py register agent-001

# 注销Agent
python3 ~/.openclaw/workspace/skills/multi-agent-memory/scripts/agent-manager.py unregister agent-001

# 列出Agent
python3 ~/.openclaw/workspace/skills/multi-agent-memory/scripts/agent-manager.py list

# 健康检查
python3 ~/.openclaw/workspace/skills/multi-agent-memory/scripts/agent-manager.py health

# 自动扩展
python3 ~/.openclaw/workspace/skills/multi-agent-memory/scripts/agent-manager.py scale

---

## 配置说明

### 默认配置

```yaml
# config/default-config.yaml
memory:
  vector_model: "nomic-embed-text-v1.5"
  vector_dim: 768
  search_mode: "rrf"  # rrf / vector / bm25
  
hooks:
  enabled: true
  count: 8
  
rrf:
  k: 60
  weights:
    bm25: 0.2
    vector: 0.5
    graph: 0.3

环境变量

# .env
MEMORY_WORKSPACE=/path/to/workspace
MEMORY_VECTOR_MODEL=nomic-embed-text-v1.5
MEMORY_LLM_API_KEY=your-api-key

示例项目

单Agent示例

cd examples/single-agent
python3 run.py

多Agent示例

cd examples/multi-agent
python3 run.py

测试

# 运行所有测试
python3 -m pytest tests/

# 运行特定测试
python3 -m pytest tests/test-hooks.py

文档


贡献

欢迎贡献!请参阅 CONTRIBUTING.md 了解指南。


许可证

MIT License


支持