记忆同步（Memory Sync）

一款用于在模型切换时维持智能体记忆连续性的工具，支持自动敏感信息脱敏。

安装

需 Python 3.11+ 及 click 库：

pip install click

# 可选：如不使用 OpenClaw 后端，则需直接调用 API 进行摘要生成
pip install openai

快速开始

# 直接从技能目录运行
python ~/.openclaw/skills/memory-sync/memory_sync.py compare

# 或为便捷起见创建别名
alias memory-sync="python ~/.openclaw/skills/memory-sync/memory_sync.py"

# 检查记忆缺失项
memory-sync compare

# 补全今日记忆（简易提取模式 —— 快速，无需 LLM）
memory-sync backfill --today

# 使用 LLM 生成叙事性摘要（调用 OpenClaw 原生模型，无需 API Key）
memory-sync backfill --today --summarize

# 补全所有缺失日期的记忆
memory-sync backfill --all

命令列表

简易提取 vs LLM 摘要生成

backfill 命令支持两种模式：

简易提取（默认，不带 --summarize 参数）：

• 速度快，无需调用 LLM 或外部 API
• 通过关键词频次分析提取主题
• 识别关键用户提问与助手回复
• 基于文本模式检测决策标记
• 输出结构化内容，含「主题（Topics）」「关键交互（Key Exchanges）」「决策（Decisions）」三部分
• 启用 --preserve 时：手写内容将被追加到新生成文件末尾
• 适用场景：快速补全、初始配置、无 LLM 访问权限的系统

LLM 摘要生成（启用 --summarize）—— 推荐使用：

• 调用 LLM 生成叙事性摘要
• 输出连贯的 2–4 段叙述性文本
• 上下文理解与洞察提取能力更强
• 启用 --preserve 时：已有内容将被作为上下文传入 LLM，并指示其将其整合进新摘要中，保持时间顺序与主题结构
• 适用场景：日常自动化、高质量记忆文件维护

常规使用推荐命令：

# 最佳质量：LLM 摘要，同时融合已有笔记
memory-sync backfill --today --summarize --preserve

两种模式均会在写入前自动执行敏感信息脱敏。

常用工作流

初始配置

# 查看缺失项
memory-sync compare

# 补全全部历史（可能耗时较长）
memory-sync backfill --all

夜间自动化（推荐）

# 最佳实践：LLM 摘要 + 融合已有笔记
memory-sync backfill --today --summarize --preserve

# 智能模式：仅处理自上次运行后变更的日期
memory-sync backfill --incremental --summarize --preserve

# 或指定其他后端（如需）
memory-sync backfill --today --summarize --preserve --summarize-backend anthropic

补全历史断档

# 补全从上周起至今的所有日期
memory-sync backfill --since 2026-01-28 --summarize

保留手写内容并重新生成

# 重生成时保留人工编写的笔记
memory-sync backfill --date 2026-02-05 --force --preserve --summarize

敏感信息脱敏（Secret Sanitization）

所有内容在写入前均自动脱敏，防止密钥泄露：

• 30+ 显式匹配规则：OpenAI、Anthropic、GitHub、AWS、Stripe、Discord、Slack、Notion、Google、Brave、Tavily、SerpAPI 等
• 结构化检测：JWT Token、SSH 密钥、数据库连接字符串、高熵 Base64 字符串等
• 通用模式：API Key、Token、密码、环境变量等
• 纵深防御：脱敏贯穿全流程（提取阶段、LLM 处理阶段、文件写入阶段、CLI 输出阶段）

敏感信息统一替换为 [REDACTED-TYPE] 占位符。

完整规则列表请参阅 SECRET_PATTERNS.md。

摘要生成后端（Summarization Backends）

--summarize 参数支持通过 --summarize-backend 指定多种后端：

示例

# 默认：使用 OpenClaw 原生模型（无需 API Key）
memory-sync backfill --today --summarize

# 显式指定后端
memory-sync backfill --today --summarize --summarize-backend openclaw
memory-sync backfill --today --summarize --summarize-backend anthropic
memory-sync backfill --today --summarize --summarize-backend openai

# 为任意后端覆盖模型名称
memory-sync backfill --today --summarize --model claude-sonnet-4-20250514
memory-sync backfill --today --summarize --summarize-backend openai --model gpt-4o

推荐使用 openclaw 后端，因其：

• 复用您现有的 OpenClaw 配置
• 无需额外配置 API Key
• 自动采用您在 OpenClaw 中设定的模型

自动化使用方式

夜间定时任务（每日凌晨 3 点）

对当日数据执行 LLM 摘要生成，并保留已有笔记：

0 3 * * * cd ~/.openclaw/skills/memory-sync && python memory_sync.py backfill --today --summarize --preserve >> ~/.memory-sync/cron.log 2>&1

智能增量模式

自动检测自上次运行以来发生变化的日期：

# 初始全量补全（仅运行一次，采用简易提取以提升速度）
python memory_sync.py backfill --all

# 后续设置夜间增量任务（含 LLM 摘要）
0 3 * * * cd ~/.openclaw/skills/memory-sync && python memory_sync.py backfill --incremental --summarize --preserve >> ~/.memory-sync/cron.log 2>&1

状态信息保存于 ~/.memory-sync/state.json。

配置

默认路径：

• 会话日志：~/.openclaw/agents/main/sessions/*.jsonl
• 记忆文件：~/.openclaw/workspace/memory/

可通过 CLI 参数覆盖：

• --sessions-dir /path/to/sessions
• --memory-dir /path/to/memory

环境变量（仅适用于直连 API 的后端）：

• ANTHROPIC_API_KEY —— 用于 --summarize-backend anthropic
• OPENAI_API_KEY —— 用于 --summarize-backend openai

默认的 openclaw 后端无需 API Key，它直接复用您的 OpenClaw 配置。

# 仅当使用直连 API 后端时才需设置
export ANTHROPIC_API_KEY=sk-ant-...
export OPENAI_API_KEY=sk-...

内容保留机制（Content Preservation）

--preserve 标志的行为取决于是否同时启用 --summarize：

未启用 --summarize（简易提取模式）：

• 位于页脚标记之后的手写内容将被原样追加至新生成文件末尾
• 新生成的自动内容将覆盖原有自动部分，而您的笔记保留在文件末尾

启用 --summarize（LLM 模式）：

• 已有的手写内容将被作为上下文传入 LLM
• LLM 将被明确指示将您的笔记整合进新摘要中
• 结果：您的洞见被有机融入连贯叙事，而非简单拼接

示例：

# 使用 LLM 重新生成，并将现有笔记融入摘要中
memory-sync backfill --date 2026-02-05 --force --preserve --summarize

自动生成的标记：

• 页眉：*Auto-generated from N session messages*
• 页脚：*Review and edit this draft to capture what's actually important.*

页脚标记之后的内容被视为手写内容，将被保留。

补全选项（Backfill Options）

日期选择（任选其一）：

• --date YYYY-MM-DD —— 指定单日
• --today —— 仅当前日期（适用于夜间自动化）
• --since YYYY-MM-DD —— 自指定日期起至当前（适用于断档恢复）
• --all —— 所有缺失日期（适用于初始配置）
• --incremental —— 仅上次运行后发生变更的日期（智能自动化）

其他参数：

• --dry-run —— 预览将生成的内容，不实际写入文件
• --force —— 强制覆盖已有文件（重生成必需）
• --preserve —— 重生成时保留手写内容
• --summarize —— 启用 LLM 生成叙事性摘要
• --summarize-backend BACKEND —— 摘要后端：openclaw（默认）、anthropic、openai
• --model MODEL —— 摘要模型（各后端默认值不同）

性能参考