Session Memory Manual

跨 Session 记忆查找与同步机制，完全手动触发

Security Scan

The skill's requirements and instructions align with its stated purpose: it performs manual, user‑initiated local searches of session history and memory files and does not request extra credentials or installs.

Purpose & Capability

Name/description describe cross‑session memory lookup and sync; the skill only references local session listing/history tools and local memory files (~/.openclaw/...), which are exactly what this purpose needs. The small index.js is a harmless placeholder.

Instruction Scope

SKILL.md instructs reading local session JSONL files, using sessions_list/sessions_history, grep/find, and writing memory/*.md — all consistent with the stated function. It documents user confirmation before reads/writes and repeatedly emphasizes manual trigger and privacy constraints. Note: the enforcement of prompts is instructional text; verify at runtime that the agent indeed prompts before executing reads/writes.

Install Mechanism

No install spec and no network downloads. Instruction‑only skill with a tiny placeholder JS file: low installation risk.

Credentials

The skill declares no env vars, no credentials, and asks for no external tokens. The operations are local file reads/writes; this is proportionate to the described functionality.

Persistence & Privilege

always:false and user‑invocable:true. The skill does not request permanent elevated presence or modify other skills or system settings. It writes to memory files only after user confirmation per the documentation.

Assessment

This skill appears coherent and low risk, but before installing: (1) confirm that the agent runtime actually prompts and waits for explicit user confirmation before any session read/write (the SKILL.md is an instruction that must be respected at runtime); (2) inspect your memory files (memory/, MEMORY.md) and session directories to ensure they don't already contain secrets; (3) test the skill in a safe account to observe exactly which files it reads/writes; (4) if you are concerned about autonomous agent actions, keep an eye on agent audit logs or restrict agent permissions to the .openclaw workspace. If any behavior deviates from the documented manual‑trigger flow, treat it as suspicious and revoke the skill.

session-memory-sync Skill

跨 Session 记忆查找与同步机制

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

⚠️ 安全设计原则

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

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

触发机制

🎯 完全手动触发

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

• ✅ "帮我查一下昨天的事"
• ✅ "搜索一下其他 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: 执行检索

优先顺序：

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

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

2. 再查 session 历史 - 完整但较慢

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

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

   sessions_list(activeMinutes=1440, messageLimit=10)
   

Step 3: 提取并同步

将找到的重要信息：

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

输出格式

检索结果

## 跨 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` - [待决定是否纳入]

最佳实践

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