From abaf1b5719a3af513d416e56d85959638a86ede7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Eason=20=28=E9=99=88=E5=8C=BB=E7=94=9F=29?=
 <eason@openclaw.ai>
Date: Thu, 26 Feb 2026 23:39:01 +0000
Subject: [PATCH] =?UTF-8?q?fix(mem0):=20=E5=8D=95=E5=BA=93=E8=9E=8D?=
 =?UTF-8?q?=E5=90=88=E6=9E=B6=E6=9E=84=E4=BF=AE=E6=AD=A3=20-=20=E7=BB=9F?=
 =?UTF-8?q?=E4=B8=80=E4=BD=BF=E7=94=A8=20mem0=5Fglobal=5Fv4=20+=20agent=5F?=
 =?UTF-8?q?id=20=E5=85=83=E6=95=B0=E6=8D=AE=E9=9A=94=E7=A6=BB?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

🚨 修复致命架构错误：

1. Embedding 模型修正:
   - 注释更新：text-embedding-v3 → text-embedding-v4 (Gemini Pro)
   - 所有配置文件统一使用 v4 模型

2. 摧毁多 Collection 物理隔离:
   - config.yaml: mem0_v4_local → mem0_global_v4
   - config-life.yaml: mem0_v4_life → mem0_global_v4
   - skill.json: mem0_local → mem0_global_v4
   - life-agent.json: mem0_v4_life → mem0_global_v4
   - mem0_client.py: mem0_v4_shared → mem0_global_v4

3. 单库融合 + 元数据软隔离:
   - 所有 Agent 共享唯一 Collection: mem0_global_v4
   - 通过 metadata.agent_id 区分 (main/life)
   - 检索时使用 filters={"agent_id": "..."} 过滤

架构优势:
- ✅ 避免向量数据库崩溃风险 (维度统一)
- ✅ 降低运维复杂度 (单 Collection)
- ✅ 支持跨 Agent 记忆共享 (可选)
- ✅ 符合 Mem0 最佳实践
---
 agents/life-agent.json                   |   2 +-
 docs/SYSTEM_ARCHITECTURE.md              | 397 +++++++++++++++++++++++
 skills/mem0-integration/config-life.yaml |  18 +-
 skills/mem0-integration/mem0_client.py   |   6 +-
 skills/mem0-integration/skill.json       |   2 +-
 5 files changed, 407 insertions(+), 18 deletions(-)
 create mode 100644 docs/SYSTEM_ARCHITECTURE.md

diff --git a/agents/life-agent.json b/agents/life-agent.json
index 903488f..bbfc180 100644
--- a/agents/life-agent.json
+++ b/agents/life-agent.json
@@ -24,7 +24,7 @@
         "dashscope_api_key": "${DASHSCOPE_API_KEY}",
         "qdrant_host": "localhost",
         "qdrant_port": 6333,
-        "collection_name": "mem0_v4_life"
+        "collection_name": "mem0_global_v4"
       }
     },
     {
diff --git a/docs/SYSTEM_ARCHITECTURE.md b/docs/SYSTEM_ARCHITECTURE.md
new file mode 100644
index 0000000..5e88cc5
--- /dev/null
+++ b/docs/SYSTEM_ARCHITECTURE.md
@@ -0,0 +1,397 @@
+# 系统架构文档 - 单一实体多 Agent 结构
+
+**文档版本:** 2026-02-26  
+**架构师:** Eason (陈医生) 👨‍⚕️  
+**部署环境:** Ubuntu 24.04 LTS VPS (KVM)
+
+---
+
+## 🏗️ 整体架构概览
+
+```
+┌─────────────────────────────────────────────────────────────────────────┐
+│                        王院长的多 Agent 系统                              │
+│                    单一实体 · 多 Agent 协作 · 统一管理                      │
+└─────────────────────────────────────────────────────────────────────────┘
+
+┌─────────────────────────────────────────────────────────────────────────┐
+│                           接入层 (Access Layer)                          │
+├─────────────────────────────────────────────────────────────────────────┤
+│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐    │
+│  │   WebChat   │  │  Telegram   │  │  Tailscale  │  │   Nginx     │    │
+│  │  (本地调试)  │  │  (@bot)     │  │  (远程访问)  │  │ (反向代理)   │    │
+│  └──────┬──────┘  └──────┬──────┘  └──────┬──────┘  └──────┬──────┘    │
+│         │                │                │                │            │
+│         └────────────────┴────────────────┴────────────────┘            │
+│                                  │                                       │
+│                        ┌─────────▼─────────┐                            │
+│                        │  OpenClaw Gateway  │                            │
+│                        │   Port: 18789      │                            │
+│                        │   Bind: Tailscale  │                            │
+│                        └─────────┬─────────┘                            │
+└──────────────────────────────────┼──────────────────────────────────────┘
+                                   │
+                    ┌──────────────┴──────────────┐
+                    │                             │
+           ┌────────▼────────┐          ┌────────▼────────┐
+           │   Main Agent    │          │  Life Agent     │
+           │    (Eason)      │          │  (张大师)        │
+           │  架构师/管理员   │          │  生活与运程助手  │
+           │  Session: main  │          │  Session: life  │
+           └────────┬────────┘          └────────┬────────┘
+                    │                             │
+                    └──────────────┬──────────────┘
+                                   │
+                    ┌──────────────▼──────────────┐
+                    │     共享基础设施层           │
+                    │  (Shared Infrastructure)    │
+                    └─────────────────────────────┘
+```
+
+---
+
+## 👥 Agent 角色与职责
+
+### 1. Eason (主 Agent) - 架构师/系统管理员
+
+| 属性 | 值 |
+|------|-----|
+| **Agent ID** | `main` |
+| **角色** | AI Agent 架构师 / 系统管理员 |
+| **职责** | 系统管理、Agent 协调、安全审计、配置优化 |
+| **工作区** | `/root/.openclaw/workspace` |
+| **Session** | `main` (直接对话) |
+| **模型** | `bailian/qwen3.5-plus` |
+| **服务对象** | 王院长 |
+
+**核心能力:**
+- 🔧 系统配置与管理
+- 🛡️ 安全审计与加固
+- 📊 性能监控与优化
+- 📝 知识沉淀与文档
+- 🤖 子 Agent 协调与部署
+
+---
+
+### 2. 张大师 (Life Agent) - 生活与运程助手
+
+| 属性 | 值 |
+|------|-----|
+| **Agent ID** | `life` |
+| **角色** | 生活与运程助手 |
+| **职责** | 日程管理、黄历查询、运程推送、生活建议 |
+| **工作区** | `/root/.openclaw/workspace/agents/life-workspace` |
+| **Session** | `life` |
+| **模型** | `bailian/qwen3.5-plus` |
+| **Telegram** | `@master_zhang_bot` |
+| **定时任务** | 每日 21:00 推送运程 |
+
+**核心能力:**
+- 📅 Google Calendar 日程管理
+- 📜 中国传统黄历查询
+- 🔮 每日运程推送
+- 🧠 记忆系统（用户偏好、生辰八字）
+
+---
+
+## 🏛️ 物理文件架构
+
+```
+/root/.openclaw/
+├── config.json                          # 主配置文件 (Gateway)
+├── workspace/                           # 共享工作区 (Git 仓库)
+│   ├── openclaw-config.json             # 工作区配置
+│   ├── MEMORY.md                        # 长期记忆
+│   ├── memory/                          # 每日记忆日志
+│   │   ├── 2026-02-26.md
+│   │   └── ...
+│   ├── agents/
+│   │   ├── registry.md                  # Agent 注册表
+│   │   ├── life-agent.json              # 张大师配置
+│   │   └── life-workspace/              # 张大师工作区
+│   │       ├── AGENTS.md
+│   │       ├── SOUL.md
+│   │       ├── memory/
+│   │       └── skills/
+│   ├── skills/                          # 共享技能库
+│   │   ├── mem0-integration/            # 记忆系统
+│   │   ├── chinese-almanac/             # 黄历查询
+│   │   ├── google-calendar-node/        # 日历管理
+│   │   ├── system-date/                 # 日期获取
+│   │   ├── tavily/                      # 网络搜索
+│   │   └── openclaw-wecom/              # 企业微信 (待部署)
+│   ├── logs/
+│   │   ├── operations/                  # 操作日志
+│   │   ├── system/                      # 系统日志
+│   │   ├── agents/                      # Agent 日志
+│   │   └── security/                    # 安全审计
+│   └── deploy.sh                        # 部署脚本
+├── agents/
+│   ├── main/                            # Eason 运行时状态
+│   │   └── agent/
+│   └── life/                            # 张大师运行时状态
+│       └── agent/
+└── backups/                             # 备份目录
+    └── workspace-YYYYMMDD-HHMMSS.tar.gz
+```
+
+---
+
+## 🔧 共享基础设施
+
+### 1. 记忆系统 (Memory System)
+
+```
+┌──────────────────────────────────────────────────────┐
+│                  记忆系统架构                         │
+├──────────────────────────────────────────────────────┤
+│  ┌─────────────┐     ┌─────────────┐                │
+│  │  Mem0 Core  │────▶│   Qdrant    │                │
+│  │  (Python)   │     │  (Vector DB)│                │
+│  └──────┬──────┘     └──────┬──────┘                │
+│         │                   │                        │
+│         │  Embedding        │  1024 维度             │
+│         │  (DashScope)      │  localhost:6333        │
+│         ▼                   ▼                        │
+│  ┌─────────────────────────────────────┐            │
+│  │      MEMORY.md + memory/*.md        │            │
+│  │      (文本记忆 · Git 版本控制)        │            │
+│  └─────────────────────────────────────┘            │
+└──────────────────────────────────────────────────────┘
+```
+
+**配置:**
+- **Qdrant:** `localhost:6333`
+- **Embedding:** DashScope `text-embedding-v3` (1024 维度)
+- **Collection:** `mem0_v4_main`, `mem0_v4_life` (隔离)
+- **更新频率:** 每 5 分钟自动同步
+
+---
+
+### 2. 系统服务 (Systemd Services)
+
+| 服务名 | 类型 | 状态 | 职责 |
+|--------|------|------|------|
+| `openclaw-gateway.service` | User-level | ✅ Active | Gateway 主服务 (Port 18789) |
+| `openclaw-agent-monitor.service` | System-level | ✅ Active | 健康监控与自动恢复 |
+
+**监控特性:**
+- 每 30 秒健康检查
+- 崩溃自动重启 (max 5 次/5 分钟)
+- Telegram 告警通知
+- 资源限制 (CPU 80%, Memory 2G)
+
+---
+
+### 3. 网络架构
+
+```
+┌─────────────────────────────────────────────────────┐
+│                  网络访问路径                        │
+├─────────────────────────────────────────────────────┤
+│                                                     │
+│  公网用户                                            │
+│      │                                              │
+│      ▼                                              │
+│  ┌─────────────┐                                    │
+│  │  Tailscale  │  WireGuard 加密                    │
+│  │  100.115.94.1 │  仅 5 台信任设备可访问              │
+│  └──────┬──────┘                                    │
+│         │                                           │
+│         ▼                                           │
+│  ┌─────────────────────────────────────────────┐   │
+│  │        OpenClaw Gateway (Port 18789)        │   │
+│  │        Bind: Tailscale 接口                  │   │
+│  │        Auth: Token (48 字符)                 │   │
+│  └─────────────────────────────────────────────┘   │
+│                                                     │
+└─────────────────────────────────────────────────────┘
+```
+
+**安全特性:**
+- Tailscale WireGuard 加密传输
+- Token 认证 (48 字符十六进制)
+- 仅 5 台信任设备可访问
+- 无公网端口暴露
+
+---
+
+## 🔄 Agent 协作模式
+
+### 单一实体架构
+
+```
+┌─────────────────────────────────────────────────────┐
+│                 单一 Gateway 实例                     │
+│              (OpenClaw Gateway v2026.2.19-2)          │
+└─────────────────────────────────────────────────────┘
+                         │
+         ┌───────────────┼───────────────┐
+         │               │               │
+         ▼               ▼               ▼
+   ┌──────────┐   ┌──────────┐   ┌──────────┐
+   │ Session  │   │ Session  │   │ Session  │
+   │  (main)  │   │  (life)  │   │  (new)   │
+   │  Eason   │   │ 张大师    │   │  未来    │
+   └──────────┘   └──────────┘   └──────────┘
+```
+
+**关键特性:**
+1. **单一 Gateway** - 所有 Agent 共享同一个 Gateway 实例
+2. **Session 隔离** - 每个 Agent 有独立的 session 和上下文
+3. **共享技能** - skills/ 目录下的技能所有 Agent 可用
+4. **独立配置** - 每个 Agent 有自己的 workspace 和配置
+5. **统一管理** - Eason 负责所有 Agent 的部署和优化
+
+---
+
+## 📊 资源配置
+
+### 计算资源
+
+| 资源 | 总量 | Gateway 使用 | Monitor 使用 | 可用 |
+|------|------|-------------|-------------|------|
+| **CPU** | 4 核 | 80% 限制 | 20% 限制 | - |
+| **内存** | 3.8GB | 558MB | 24MB | 3.2GB |
+| **磁盘** | 63GB | 25GB 已用 | - | 37GB |
+
+### 模型配置
+
+```json
+{
+  "primary": "bailian/qwen3.5-plus",
+  "fallbacks": [
+    "bailian/qwen3.5-plus-2026-02-15",
+    "minimax-cn/MiniMax-M2.5"
+  ]
+}
+```
+
+---
+
+## 🔐 安全架构
+
+### 分层防护
+
+```
+┌─────────────────────────────────────────────────────┐
+│  Layer 1: 网络层                                     │
+│  - Tailscale WireGuard 加密                         │
+│  - 仅信任设备可访问 (5 台)                            │
+│  - 无公网端口暴露                                    │
+└─────────────────────────────────────────────────────┘
+                         │
+                         ▼
+┌─────────────────────────────────────────────────────┐
+│  Layer 2: 认证层                                     │
+│  - Token 认证 (48 字符)                              │
+│  - 设备认证 (已知权衡：HTTP 下禁用)                    │
+│  - 速率限制 (可选)                                   │
+└─────────────────────────────────────────────────────┘
+                         │
+                         ▼
+┌─────────────────────────────────────────────────────┐
+│  Layer 3: 应用层                                     │
+│  - 插件白名单 (待启用)                               │
+│  - 会话隔离                                          │
+│  - 权限控制                                          │
+└─────────────────────────────────────────────────────┘
+```
+
+---
+
+## 📈 扩展性设计
+
+### 新增 Agent 流程
+
+```
+1. 定义 Agent 功能
+   │
+   ▼
+2. 创建配置文件 (agents/life-agent.json 模板)
+   │
+   ▼
+3. 注册到 registry.md
+   │
+   ▼
+4. 配置技能和模型
+   │
+   ▼
+5. 设置 systemd 服务 (可选)
+   │
+   ▼
+6. 配置监控和日志
+   │
+   ▼
+7. 测试验证
+   │
+   ▼
+8. 更新 MEMORY.md
+```
+
+### 容量规划
+
+| 指标 | 当前 | 上限 | 备注 |
+|------|------|------|------|
+| Agent 数量 | 2 | ~10 | 受内存限制 |
+| 并发 Session | 5 | 20 | Gateway 配置 |
+| 记忆条目 | ~1000 | 无限制 | Qdrant 向量库 |
+
+---
+
+## 📝 运维命令
+
+### 服务管理
+
+```bash
+# 查看状态
+./deploy.sh status
+
+# 重启服务
+./deploy.sh restart
+
+# 健康检查
+./deploy.sh health
+
+# 查看日志
+./deploy.sh logs
+```
+
+### Git 管理
+
+```bash
+# 提交配置
+cd /root/.openclaw/workspace
+git add -A
+git commit -m "描述"
+git push origin master
+
+# 回滚
+./deploy.sh rollback
+```
+
+### 备份
+
+```bash
+# 手动备份
+./deploy.sh backup
+
+# 备份位置
+/root/.openclaw/backups/workspace-YYYYMMDD-HHMMSS.tar.gz
+```
+
+---
+
+## 🎯 待扩展功能
+
+| 功能 | 优先级 | 状态 |
+|------|--------|------|
+| 企业微信集成 | 中 | 技能已开发，待部署 |
+| Prometheus 监控 | 低 | 规划中 |
+| 自动化 CI/CD | 低 | 规划中 |
+| 多节点高可用 | 低 | 远期规划 |
+
+---
+
+**最后更新:** 2026-02-26 21:20 UTC  
+**维护人:** Eason (陈医生)
diff --git a/skills/mem0-integration/config-life.yaml b/skills/mem0-integration/config-life.yaml
index 6f003e1..ad81b63 100644
--- a/skills/mem0-integration/config-life.yaml
+++ b/skills/mem0-integration/config-life.yaml
@@ -1,15 +1,16 @@
 # mem0 Integration Configuration - 张大师专用
 # Agent ID: life (生活与运程助手)
 # 用户生辰：1984 年 5 月 16 日 23:00-24:00 (子时)
+# 架构：单库融合 + 元数据标签软隔离 (agent_id: "life")
 
-# 本地 Qdrant 配置
-local:
+# 全局 Qdrant 配置（所有 Agent 共享同一个 Collection）
+global:
   vector_store:
     provider: qdrant
     config:
       host: localhost
       port: 6333
-      collection_name: mem0_v4_life  # 张大师专用集合
+      collection_name: mem0_global_v4  # 唯一全局 Collection，通过 agent_id 区分
   
   llm:
     provider: openai
@@ -21,19 +22,10 @@ local:
   embedder:
     provider: openai
     config:
-      model: text-embedding-v4
+      model: text-embedding-v4  # Gemini Pro Embedding (1024 维度)
       api_base: https://dashscope.aliyuncs.com/compatible-mode/v1
       api_key: ${DASHSCOPE_API_KEY}
 
-# 中心 Qdrant 配置（共享记忆 - 与陈医生共享）
-master:
-  vector_store:
-    provider: qdrant
-    config:
-      host: 100.115.94.1
-      port: 6333
-      collection_name: mem0_v4_shared
-
 # 同步配置
 sync:
   enabled: true
diff --git a/skills/mem0-integration/mem0_client.py b/skills/mem0-integration/mem0_client.py
index c11a9ad..2933fc7 100644
--- a/skills/mem0-integration/mem0_client.py
+++ b/skills/mem0-integration/mem0_client.py
@@ -14,7 +14,7 @@ from collections import deque
 from datetime import datetime
 
 # ========== DashScope 环境变量配置 ==========
-# 标准计费通道 (text-embedding-v3 专用)
+# Gemini Pro Embedding 模型：text-embedding-v4 (1024 维度)
 os.environ['OPENAI_API_BASE'] = 'https://dashscope.aliyuncs.com/compatible-mode/v1'
 os.environ['OPENAI_BASE_URL'] = 'https://dashscope.aliyuncs.com/compatible-mode/v1'  # 关键：兼容模式需要此变量
 os.environ['OPENAI_API_KEY'] = os.getenv('MEM0_DASHSCOPE_API_KEY', 'sk-4111c9dba5334510968f9ae72728944e')
@@ -138,12 +138,12 @@ class Mem0Client:
         self._init_memory()
     
     def _load_default_config(self) -> Dict:
-        """加载默认配置"""
+        """加载默认配置 - 单库融合架构"""
         return {
             "qdrant": {
                 "host": os.getenv('MEM0_QDRANT_HOST', 'localhost'),
                 "port": int(os.getenv('MEM0_QDRANT_PORT', '6333')),
-                "collection_name": "mem0_v4_shared"
+                "collection_name": "mem0_global_v4"  # 唯一全局 Collection
             },
             "llm": {
                 "provider": "openai",
diff --git a/skills/mem0-integration/skill.json b/skills/mem0-integration/skill.json
index 737bced..5b6eb50 100644
--- a/skills/mem0-integration/skill.json
+++ b/skills/mem0-integration/skill.json
@@ -22,7 +22,7 @@
     "qdrant": {
       "host": "localhost",
       "port": 6333,
-      "collection_name": "mem0_local"
+      "collection_name": "mem0_global_v4"
     },
     "llm": {
       "model": "qwen-plus",