ChronoSync_IT运维与安全 skill-PHP中文网

ChronoSync

Polar Sponsor

爱发电赞助

.NET 9.0

立即下载

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

Session Sync - 跨会话记忆同步

功能概述

Session Sync - 跨会话记忆同步是一项面向实际任务的技能，主要用于一句话：让 OpenClaw 各会话共享聊天记录，换会话不丢上下文；解决什么问题？

核心要点

OpenClaw 的每个会话是独立的，切换会话后无法访问其他会话的历史记录；
这个技能帮你：；
✅ 自动同步各会话聊天记录到共享文件；

使用与执行

✅ 跨会话访问历史消息；✅ 增量同步，避免重复存储；✅ 支持 JSON + Markdown 双格式输出；1. 安装前检查。它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。

结果检查与注意事项

从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。

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          # 变化检测缓存

安全验证

已通过以下测试：

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

配置（可选）

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

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

插件系统

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

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

开发自定义插件

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

后续计划

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