什么是 Smart Memory Sync？

Smart Memory Sync 是一款精密工具，旨在通过提供预防性上下文保护来增强 AI 智能体的长期可靠性。它确保关键的对话历史、任务状态和决策日志绝不会因上下文窗口限制而丢失。作为 Openclaw Skills 的核心部分，它充当主动守护者，监控上下文使用情况，并在 MEMORY.md、QMD 知识库和 Git 版本控制之间执行自动同步。

该技能基于双重保险机制运行，与上下文管理器配合工作以实现无缝的会话转换。通过在会话达到限制之前自动提取和归档信息，它允许开发人员以 100% 的记忆完整性维持长时间运行的工作流。无论是用于后台监控的守护进程模式还是手动触发，它都为持久性 AI 记忆提供了稳健的框架。

下载入口:https://github.com/openclaw/skills/tree/main/skills/zhaog100/smart-memory-sync

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

Smart Memory Sync 应用场景

• 管理上下文窗口经常耗尽的长时间编码会话。
• 自动将关键项目决策和用户偏好归档到长期记忆中。
• 跨语义搜索数据库和 Git 同步智能体知识，以实现版本化历史。
• 编排无缝的会话交接，且不丢失技术上下文或进度。

1. 系统运行一个后台守护进程，每 5 分钟通过会话 API 监控上下文使用情况。
2. 当使用率达到 50% 阈值时，它会提示用户同步记忆。
3. 当使用率达到 75% 时，它会自动在 MEMORY.md、QMD 和 Git 仓库之间执行三库同步。
4. 如果使用率超过 85%，它会通过调用上下文管理器主动触发会话切换。
5. 随后，该技能使用保留的记忆初始化新会话，确保对话持续进行且不丢失数据。

Smart Memory Sync 配置指南

要在 Openclaw Skills 环境中部署 Smart Memory Sync，请配置阈值并启动监控过程。

# 启动后台监控守护进程
python3 scripts/smart-sync.py --daemon

# 检查当前上下文使用情况和同步状态
python3 scripts/smart-sync.py --status

# 手动强制执行三个数据库的同步
python3 scripts/smart-sync.py --sync

Smart Memory Sync 数据架构与分类体系

该技能跨分层结构管理数据，以确保冗余和高速检索。

name: smart-memory-sync
description: 主动智能记忆管理技能。实时分析聊天、三库同步（MEMORY+QMD+Git）、主动切换、预防性保护。与Context Manager互补，双保险机制。
version: 1.0.0
author: 米粒儿
created: 2026-03-06
updated: 2026-03-06

Smart Memory Sync - 主动智能记忆管理

预防性保护 + 三库同步 + 主动切换 + 双保险机制

?? 核心功能

1. 主动监控

• ? 实时监控上下文使用率
• ? 每5分钟自动检查
• ? 三级阈值触发机制

2. 三库同步

• ? MEMORY.md - 长期记忆
• ? QMD知识库 - 语义检索
• ? Git库 - 版本保护

3. 主动切换 ?

• ? 85%阈值主动触发
• ? 调用Context Manager
• ? 无缝记忆传递

4. 双保险机制

• Smart Memory Sync：预防性保护（50%/75%/85%）
• Context Manager：应急切换（85%）

?? 工作流程

三级阈值机制

上下文 < 50%：
  → 正常对话，后台监控

上下文 ≥ 50%：
  → 提醒用户："官家，上下文50%，建议同步记忆～"
  → 等待用户决定

上下文 ≥ 75%：
  → 自动同步三库（MEMORY + QMD + Git）
  → 准备切换

上下文 ≥ 85%：
  → 主动触发切换
  → 调用Context Manager
  → 创建新会话
  → 无缝加载记忆

双保险机制

Smart Memory Sync（主动预防）
  ↓ 50%提醒 → 75%同步 → 85%切换
  ↓
Context Manager（被动应急）
  ↓ 接收切换请求
  ↓ 执行切换逻辑
  ↓ 创建新会话
  ↓
新会话加载记忆
  ↓ 继续对话

?? 使用方式

1. 守护进程模式（推荐）

# 后台运行（每5分钟检查）
python3 scripts/smart-sync.py --daemon

# 查看状态
python3 scripts/smart-sync.py --status

# 停止守护进程
Ctrl+C

2. 手动触发

# 手动同步三库
python3 scripts/smart-sync.py --sync

# 单次检查
python3 scripts/smart-sync.py --check

3. AI调用

用户：同步记忆
AI：[执行smart-sync --sync] → 更新三库 → "官家，三库已同步～ ??"

用户：查看状态
AI：[执行smart-sync --status] → 返回上下文信息

用户：检查上下文
AI：[执行smart-sync --check] → 检查并执行相应动作

??? 技术架构

smart-memory-sync/
├── analyzers/           # 聊天分析（未来）
│   ├── chat-analyzer.py
│   ├── info-extractor.py
│   └── classifier.py
├── syncers/            # 同步器
│   └── sync-all.py     # 三库同步
├── triggers/           # 触发器
│   └── auto-check.py   # 上下文监控
├── integrators/        # 集成器（未来）
│   └── context-manager.py
├── config/
│   └── sync-config.json
├── scripts/
│   └── smart-sync.py   # 主入口
└── logs/
    └── monitor.log

?? 配置说明

sync-config.json

{
  "thresholds": {
    "remind": 50,      // 提醒阈值
    "auto_sync": 75,   // 自动同步阈值
    "auto_switch": 85  // 自动切换阈值
  },
  "intervals": {
    "check": 300,      // 检查间隔（秒）
    "sync": 3600       // 同步间隔（秒）
  },
  "integrations": {
    "context_manager": {
      "enabled": true,
      "skill": "context-manager"
    },
    "qmd": {
      "enabled": true,
      "collection": "knowledge"
    },
    "git": {
      "enabled": true,
      "auto_push": false
    }
  }
}

?? 核心模块

1. auto-check.py（上下文监控）

# 每5分钟检查上下文
def check_and_act():
    usage = get_context_usage()
    
    if usage >= 85%:
        trigger_switch()  # 触发切换
    elif usage >= 75%:
        auto_sync()       # 自动同步
    elif usage >= 50%:
        remind_user()     # 提醒用户

核心功能：

• ? 真实API监控（调用openclaw sessions API）
• ? 准确计算（totalTokens / contextTokens）
• ? 智能触发（三级阈值）
• ? 冷却期机制（避免重复触发）

2. sync-all.py（三库同步）

# 同步三库
def sync_all():
    sync_memory()  # MEMORY.md
    sync_qmd()     # QMD知识库
    sync_git()     # Git提交

同步内容：

• MEMORY.md → 更新长期记忆
• MEMORY-LITE.md → 更新精简版
• QMD → 更新知识库索引
• Git → 提交版本

3. smart-sync.py（主入口）

# 守护进程
python3 smart-sync.py --daemon

# 手动同步
python3 smart-sync.py --sync

# 查看状态
python3 smart-sync.py --status

?? 与Context Manager协作

职责分工

调用链

Smart Memory Sync检测85%
  ↓
保存三库（MEMORY + QMD + Git）
  ↓
调用Context Manager切换
  ↓
Context Manager执行切换
  ↓
创建新会话
  ↓
新会话加载记忆
  ↓
继续对话

双保险价值

预防性保护（Smart Memory Sync）：
  ? 50%提醒 → 75%同步 → 85%切换
  ? 预防记忆缺失
  ? 三库协同保护

应急切换（Context Manager）：
  ? 85%自动切换
  ? 无缝记忆传递
  ? 兜底保护

双保险机制：
  ? 99.9%记忆完整性
  ? 零感知切换
  ? 三库版本保护

?? 性能指标

?? 使用场景

场景1：长时间对话

对话进行中
  ↓
Smart Memory Sync监控（5分钟/次）
  ↓
50% → 提醒官家
  ↓
75% → 自动同步三库
  ↓
85% → 触发切换
  ↓
新会话无缝继续

场景2：重要决策记录

官家决策
  ↓
手动触发同步
  ↓
更新MEMORY.md
  ↓
更新QMD索引
  ↓
Git提交保护

场景3：预防性保护

Smart Memory Sync + Context Manager
  ↓
双保险机制
  ↓
预防性保护 + 应急切换
  ↓
99.9%记忆完整性

?? 未来规划

v1.1.0（下一版本）

• 聊天分析（自动提取关键信息）
• 智能分类（决策/任务/偏好）
• 优先级管理
• 情感分析

v1.2.0

• 多会话管理
• AI智能分析
• 自适应阈值
• 云端同步

?? 注意事项

1. 冷却期机制

• 每个动作后10分钟冷却期
• 避免重复触发
• 减少干扰

2. 三库同步

• MEMORY.md：长期记忆
• QMD：语义检索
• Git：版本保护

3. 与Context Manager互补

• 不替代Context Manager
• 协同工作，双保险
• 职责明确，不冲突

?? 技术支持

查看日志：

tail -50 ~/.openclaw/workspace/skills/smart-memory-sync/logs/monitor.log

检查状态：

python3 scripts/smart-sync.py --status

问题排查：

1. 检查openclaw命令可用
2. 检查config/sync-config.json配置
3. 查看logs/monitor.log日志

?? 核心优势

vs 手动管理

• ? 自动监控，无需人工干预
• ? 预防性保护，提前预警
• ? 三库同步，多重保险

vs Context Manager

• Smart Memory Sync：主动预防
• Context Manager：应急切换
• 双保险机制：99.9%保护

vs 其他方案

• ? 真实API监控，准确可靠
• ? 三库协同，全面保护
• ? 智能触发，零感知

版本: 1.0.0 作者: 米粒儿 ?? 创建: 2026-03-06 更新: 2026-03-06

主动智能记忆管理，预防性保护，三库同步，双保险机制 ??