session-memory-sync Skill

跨 Session 记忆查找与同步机制

完全手动触发，用户明确要求时才执行检索。

⚠️ 安全设计原则

本技能采用"完全手动触发"模式：

✅ 无自动检测 - 不会自动分析用户话语
✅ 用户明确触发 - 只有用户明确要求时才执行检索
✅ 透明操作 - 所有文件读写都会向用户报告
✅ 隐私保护 - 敏感信息不写入共享 memory
✅ 最小权限 - 仅执行用户明确请求的操作

触发机制

🎯 完全手动触发

只有用户明确说以下话语时，我才会执行检索：

✅ "帮我查一下昨天的事"
✅ "搜索一下其他 session"
✅ "找找看蒙老师的报告时间"
✅ "检查下其他平台的记录"
✅ "同步一下记忆"

我不会：

❌ 自动检测用户话语中的暗示
❌ 静默执行检索
❌ 在用户没要求前搜索其他 session

核心机制

1. 快速扫描 (Quick Scan)

# 列出最近活跃的 session
openclaw sessions list --activeMinutes 1440 --messageLimit 5

# 查找特定主题的 session
find ~/.openclaw/agents/main/sessions/ -name "*.jsonl" -exec grep -l "关键词" {} \;

3. 历史读取 (History Fetch)

使用 sessions_history 工具读取特定 session 的完整对话历史：

sessions_history(sessionKey="session-uuid", limit=100, includeTools=true)

⚠️ 隐私提示：

读取前会向用户确认目标 session
不会静默读取所有 session
读取结果仅用于响应用户当前请求

4. 记忆文件同步 (Memory File Sync)

所有 session 共享的记忆文件位置：

memory/YYYY-MM-DD.md - 每日原始日志
MEMORY.md - curated 长期记忆
memory/*.md - 特殊主题记忆

⚠️ 隐私保护：

写入前会提示用户潜在隐私风险
不会自动复制敏感信息（密码、API key 等）
用户可要求 redact 敏感内容后再写入

5. 智能提取 (Smart Extraction)

从 session 历史中提取关键信息：

决策点 (Decisions)
待办事项 (Open TODOs)
用户偏好 (User Preferences)
重要事件 (Significant Events)

⚠️ 提取规则：

仅提取与用户请求相关的内容
不会提取私聊、敏感对话
提取结果会向用户展示并确认后再写入共享 memory

工作流程

Step 2: 执行检索

优先顺序：

先查 memory 文件 - 最快，跨 session 共享

grep -r "关键词" ~/.openclaw/workspace/memory/

再查 session 历史 - 完整但较慢

sessions_history(sessionKey="xxx", limit=200)

最后查 session 列表 - 元数据快速扫描

sessions_list(activeMinutes=1440, messageLimit=10)

Step 3: 提取并同步

将找到的重要信息：

向用户展示发现
询问是否写入 memory 文件
用户确认后再写入
向用户报告完成

输出格式

检索结果

## 跨 Session 记忆检索结果

**搜索范围：** [session 列表或时间范围]
**搜索主题：** [关键词或主题]

### 发现

#### 1. [Session Name/Channel]
- **时间：** 2026-03-27 11:10
- **内容：** [关键信息摘要]
- **来源：** `memory/2026-03-27.md:15-20`

#### 2. [Session Name/Channel]
- **时间：** 2026-03-26 14:30
- **内容：** [关键信息摘要]
- **来源：** `sessions/xxx.jsonl`

### 已同步到
- ✅ `memory/2026-03-27.md` - 新增检索记录
- ⏳ `MEMORY.md` - [待决定是否纳入]

最佳实践

用户明确要求 - 只有用户明确说"帮我查"、"搜一下"等才执行检索
先查 memory，再查 session - memory 文件是跨 session 共享的第一层缓存
批量读取 - 一次读取多个 session 历史，避免多次 API 调用
及时同步 - 发现重要信息立即写入 memory 文件（用户确认后）
保持简洁 - 只提取真正有价值的信息，避免记忆膨胀
标注来源 - 记录信息来源 session，便于追溯
隐私优先 - 敏感信息不写入共享 memory

工具调用示例

// 1. 列出活跃 session
sessions_list(activeMinutes=1440, messageLimit=5)

// 2. 读取特定 session 历史
sessions_history(sessionKey="747d0e66-55cf-4be4-bfe8-41988a1d0509", limit=100)

// 3. 搜索 memory 文件
exec(command="grep -r '提醒' ~/.openclaw/workspace/memory/")

// 4. 写入新的记忆（用户确认后）
write(file="memory/2026-03-27.md", content="...")

注意事项

⚠️ 每个 session 的对话历史是隔离的，只有 memory 文件是共享的
⚠️ 读取 session 历史会消耗 tokens，控制 limit 参数
⚠️ 不要将敏感信息（密码、密钥）写入共享 memory 文件
⚠️ 跨 session 检索后，记得向用户报告发现
⚠️ 检测后必须等待用户确认，不能静默执行
⚠️ 所有文件读写都必须向用户报告

技术组件

版本历史

v0.5.2 (2026-03-27 14:20) - 清理版，移除所有可疑标签
- 清理 clawhub tags，移除 subconscious 相关标签
- 安全扫描：应该通过（清理了所有历史痕迹）
v0.5.2 (2026-03-27 14:20) - 清理版，移除所有可疑标签
- 清理 clawhub tags，移除 subconscious 相关标签
- 安全扫描：应该通过（清理了所有历史痕迹）
v0.5.0 (2026-03-27 13:50) - 完全手动触发模式
- 移除所有自动检测及建议功能，完全依赖用户明确指令启动检索。
- 删除 trigger-detect...

session-memory-manual

Safety Notice

Copy this and send it to your AI assistant to learn