Session Sync - 跨会话记忆同步

一句话：让 OpenClaw 各会话共享聊天记录，换会话不丢上下文。

解决什么问题？

OpenClaw 的每个会话是独立的，切换会话后无法访问其他会话的历史记录。

这个技能帮你：

• - ✅ 自动同步各会话聊天记录到共享文件
• ✅ 跨会话访问历史消息
• ✅ 增量同步，避免重复存储
• ✅ 支持 JSON + Markdown 双格式输出

怎么用？

1. 安装前检查

bash

下载后先检查环境

如果显示 检查完成，可以正常使用！ 就可以继续。如果报错，按提示修复。

2. 安装

bash

方式1：通过 OpenClaw 安装

方式2：手动复制到技能目录

3. 配置自动备份（每30分钟）

bash
openclaw cron add session-sync \
--interval 30m \
--command python -m session_sync

3. 手动备份（现在立刻执行）

bash
python -m session_sync

会产生什么文件？

同步完成后，聊天记录会保存到：

~/.openclaw/workspace/memory/sync/
├── shared_chat.md ← Markdown 格式，方便人工阅读
├── shared_chat.json ← JSON 格式，方便程序处理
└── .last_hash ← 变化检测缓存文件

shared_chat.md 格式示例：

markdown

共享聊天记录

最后同步：2026-03-14T12:21:28

会话：abc123...

• - 消息数：200
• 最后更新：2026-03-14T04:11:29

消息 1

消息 2

实际场景

场景1：跨会话查看历史

在 Telegram 会话中聊完后，切换到 Control UI 会话：

用户：查看 Telegram 会话的最后一条消息
AI：[读取 shared_chat.json 中的 Telegram 会话记录]

场景2：会话间数据共享

在 Webhook 会话中接收外部数据，在 Telegram 会话中查看：

Webhook 接收数据 → 同步到 shared_chat.json → Telegram 会话可访问

场景3：历史记录备份

定期同步所有会话记录，防止数据丢失：

bash

手动备份

或配置定时任务自动备份

和其他方案的区别

隐私与安全

数据安全

• - ✅ 纯本地运行：所有数据保存在 ~/.openclaw/workspace/memory/sync/
• ✅ 无网络连接：仅读取本地会话文件，不访问任何外部服务
• ✅ 自动脱敏：邮箱、手机号、API Key 会被替换为 [EMAIL]、[PHONE] 等

生成文件

~/.openclaw/workspace/memory/sync/
├── shared_chat.json # 聊天记录（JSON格式）
├── shared_chat.md # 聊天记录（Markdown格式）
├── decisions/ # 提取的决策和知识点
├── todos/ # 提取的待办事项
└── .last_hash # 变化检测缓存

安全验证

1. 1. ✅ 插件系统测试：knowledge 和 todo 插件正常加载运行
2. ✅ 网络监控：运行期间无外部网络连接
3. ✅ 文件访问：仅访问 ~/.openclaw/agents/main/sessions/ 目录
4. ✅ 代码审查：import os 已正确包含，无语法错误

配置（可选）

bash

改备份目录

改 OpenClaw 目录

插件系统

Session Sync 支持插件扩展，内置以下插件：

开发自定义插件

1. 1. 创建 plugins/myplugin.py
2. 继承 Plugin 基类
3. 实现 onsync 方法
4. 创建插件实例 plugin = MyPlugin()

后续计划

版本历史

v1.0.1 (2026-03-14)

• - ✅ 修复 Windows UTF-8 编码问题
• ✅ 修复 OpenClaw 2026.3.x 路径兼容（agents/main/sessions）
• ✅ 修复插件系统导入问题

v1.0.0 (2026-03-10)

• - ✅ 基础同步功能
• ✅ JSON + Markdown 双格式输出
• ✅ 增量同步，智能去重
• ✅ 敏感信息自动脱敏

License

MIT - 免费使用，自由修改