ChronoSync

跨会话聊天记录同步工具。自动备份 OpenClaw 各会话的聊天记录， 实现会话间记忆共享，避免切换会话后丢失上下文。

Session Sync - 跨会话记忆同步

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

---

解决什么问题？

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

这个技能帮你：

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

---

怎么用？

1. 安装前检查

# 下载后先检查环境
python check_install.py

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

2. 安装

# 方式1：通过 OpenClaw 安装
openclaw skills install session-sync

# 方式2：手动复制到技能目录
cp -r session-sync ~/.openclaw/skills/

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

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

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

python -m session_sync

---

会产生什么文件？

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

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

shared_chat.md 格式示例：

# 共享聊天记录

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

---

## 会话：abc123...

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

### 消息 1
**role:** user  
**content:** [内容已脱敏]  
**timestamp:** 2026-03-14T04:11:29.776Z

### 消息 2
...

---

实际场景

场景1：跨会话查看历史

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

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

场景2：会话间数据共享

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

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

场景3：历史记录备份

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

# 手动备份
python -m session_sync

# 或配置定时任务自动备份
openclaw cron add session-sync --interval "30m" --command "python -m session_sync"

---

和其他方案的区别

	Session Sync	OpenClaw 内置 compaction
触发时机	定时任务（可配置）	系统自动触发
数据位置	workspace/memory/sync/	各会话独立存储
访问方式	跨会话共享	会话隔离
文件格式	Markdown + JSON	内部格式
脱敏处理	✅ 自动脱敏	❌ 无

---

隐私与安全

数据安全

• ✅ 纯本地运行：所有数据保存在 ~/.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. ✅ 插件系统测试：knowledge 和 todo 插件正常加载运行
2. ✅ 网络监控：运行期间无外部网络连接
3. ✅ 文件访问：仅访问 ~/.openclaw/agents/main/sessions/ 目录
4. ✅ 代码审查：import os 已正确包含，无语法错误

---

配置（可选）

# 改备份目录
export SESSION_SYNC_OUTPUT=/你的/自定义/路径

# 改 OpenClaw 目录
export OPENCLAW_STATE_DIR=/你的/openclaw/路径

---

插件系统

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

插件	功能	状态
knowledge	自动提取关键决策和知识点	✅ 已启用
todo	追踪待办事项	✅ 已启用

开发自定义插件

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

后续计划

功能	状态	说明
自动提取知识点	✅ 已实现	knowledge 插件基础功能
自动追踪待办	✅ 已实现	todo 插件基础功能
智能知识提取	🔄 待优化	使用更好的 NLP 模型
网页版查看器	❌ 未实现	计划开发 Web UI
数据可视化	❌ 未实现	聊天记录统计图表

版本历史

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 - 免费使用，自由修改