📦 OpenClaw Memory Hub

OpenClaw Memory Hub 三层内存架构，内置自动化 Dreaming 流水线与三向同步。

概述 该架构通过三层记忆解决 AI 跨会话失忆： 层级 | 技术 | 目的 L0 运行时 | memory-core 插件（Ollama bge-m3 → SQLite + sqlite-vec） | 实时语义 + BM25 混合检索 L0 云回忆 | MemOS Cloud 插件（可选） | 跨设备捕获与回忆 L1 工作记忆 | memory/YYYY-MM-DD.md 文件 | 每日摘要、待办、技术笔记（30–90 天保留） L2 长期记忆 | MEMORY.md（只读基线） | 关键事实、用户画像、永久决策

自动化流水线 Dreaming（每日 03:00 UTC）：扫描对话日志，经 DeepSeek 评估，将高分洞察晋升至 L2 三向同步（每日 18:00 / 20:00 / 22:00 CST）：保持 Cloud ↔ Markdown ↔ 向量存储一致 Wiki 汇编（每日 04:00 UTC，可选）：抽取实体与概念，写入结构化 wiki 库页

一键自动安装 bash scripts/auto-setup.sh 该脚本交互式完成全部步骤： 步骤 | 功能 | 开关 1 | 安装 Ollama（标准或 Intel 版） | --skip-ollama 2 | 下载 bge-m3 嵌入模型 | — 3 | 插件冲突检测（自动识别 subconscious-personality-guardian） | — 4 | 检查 memory-core 插件状态 | — 5 | 将 memory-core 配置写入 openclaw.json | 确认后自动插入 6 | 安装并配置 MemOS Cloud 插件及关键参数 | --skip-memos 7 | 创建 memory/ 目录，检查 AGENTS.md | — 8 | 设置 Dreaming 定时任务（03:00 UTC） | —

选项 bash scripts/auto-setup.sh --skip-ollama # 跳过 Ollama 安装 bash scripts/auto-setup.sh --skip-memos # 完全跳过 MemOS Cloud bash scripts/auto-setup.sh --dry-run # 仅预览，不改动

手动安装 详见 references/setup-guide.md

适用场景 首次部署 OpenClaw 记忆 为本地 Ollama 嵌入配置 memory-core 插件 安装 MemOS Cloud 插件实现跨设备同步 设置自动 Dreaming 与晋升流水线 配置云、文件、向量 DB 三向同步

插件冲突 ❌ subconscious-personality-guardian ↔ memory-core 共用 OpenClaw 内存槽，导致写入冲突与检索重复。 自动修复：auto-setup.sh 检测并禁用。 手动修复： { "plugins": { "disabled": ["subconscious-personality-guardian"], "deny": ["subconscious-personality-guardian"] } }

✅ memory-core + MemOS Cloud 分层设计，顺序执行： 用户消息 → MemOS Cloud（before_agent_start 钩子）注入静态事实、偏好、画像 → memory-core（运行时语义查询）注入近期对话、主题上下文 → Agent 获得分层记忆 MemOS 管“用户是谁”，memory-core 管“聊过什么”。 MemOS Cloud 关键配置： { "recallFilterFailOpen": true, "asyncMode": true, "resetOnNew": true, "hooks.allowConversationAccess": true }

⚠️ MemOS Cloud + ReMe 文件层重叠，检索重复，二选一。详见 references/architecture.md

组件

• 记忆插件（L0）

openclaw.json 配置示例： { "plugins": { "entries": { "memory-core": { "config": { "embeddingUrl": "http://127.0.0.1:11434/api/embed", "embeddingModel": "bge-m3", "dimension": 1024 } }, "memos-cloud-openclaw-plugin": { "config": { "url": "https://your-memos-server", "token": "your-token" } } } } }

• 记忆文件（L1 + L2）

~/.openclaw/workspace/ ├── memory/ │ ├── YYYY-MM-DD.md # 每日工作记忆（自动索引） │ ├── MEMORY_INDEX.md # 向量 BM25 聚类摘要 │ ├── memos-cloud-*.md # 云端拉取的记忆条目 │ ├── .sync-cloud-state.json # 云端拉取游标 │ └── .sync-push-state.json # 推送状态（SHA256 追踪） ├── MEMORY.md # 长期记忆基线（只读） ├── AGENTS.md # 运行时上下文 + 记忆规则 └── SOUL.md # Agent 人设

• 同步脚本（可选）

位于 user_workspace/scripts/： sync-cloud-pull.py # 从 MemOS Cloud 拉取 → Markdown sync-cloud-push.py # 本地 Markdown 变更推送 → Cloud（SHA256 diff） sync-vector-index.py # 向量 DB → MEMORY_INDEX.md（FTS5 BM25 聚类） sync-all.sh # 一键 orchestrator

MemOS Cloud API 详见 references/sync-api.md