Session Memory (Workspace)

Write session summaries to daily memory files and search session history so OpenClaw can recall and cite past conversations.

Security Scan

The skill’s code, runtime instructions, and requested resources are consistent with its stated purpose (reading local session JSONL files, summarizing them, and writing daily memory files); it does not request external credentials or network access.

Purpose & Capability

Name/description match behavior: the scripts read session JSONL files from ~/.openclaw/agents/main/sessions and either search them or summarize them into workspace/memory/YYYY-MM-DD.md. Required binary (node) is appropriate and necessary for the included JavaScript scripts.

Instruction Scope

SKILL.md instructs running the included node scripts and documents which paths are read/written. The instructions limit scope to session files and workspace memory; they do not ask the agent to read unrelated paths, system credentials, or call external endpoints. The scripts perform only local file I/O and text processing.

Install Mechanism

There is no install spec (instruction-only), and included files are plain Node scripts. No remote downloads, package installs, or archive extraction are performed by the skill metadata.

Credentials

The skill requires no environment variables or credentials. It accesses only the documented local session directory and the workspace memory directory; those paths are reasonable for the described functionality.

Persistence & Privilege

always is false and the skill is user-invocable; autonomous invocation is allowed (platform default) but the skill does not request heightened privileges or modify other skills or global agent settings. It writes only to the workspace memory files that its description declares.

Assessment

This skill is coherent: it reads local OpenClaw session logs and writes/updates per-day memory markdown files so the agent can recall past conversations. Before installing, confirm you are comfortable with the agent reading your session JSONL files and adding their summaries to workspace/memory (these files may contain sensitive content). Also ensure Node.js is available. If you do not want automatic summarization, avoid running the summarize script or restrict who can invoke the skill; when enabled the agent can call the scripts (autonomous invocation is the platform default).

session-memory

Use this skill when the user asks to remember yesterday’s (or a date’s) chat, to summarize a day’s sessions into memory, or to search past conversations (by keyword or date). It bridges session logs and the memory store so OpenClaw can answer “what did we talk about on …?” and use session context in replies.

When to use

• User asks: “把昨天的聊天记到记忆里” / “总结一下 2 月 27 日的对话并写入 memory”
• User asks: “查一下之前我们说过关于 XXX 的对话” / “搜索会话里关于 discord/股票 的内容”
• User wants past chats to be searchable via memory/citations → run the summarize script for that day first, then normal memory search will include it.

Paths (default agent)

• Sessions: ~/.openclaw/agents/main/sessions/
  • sessions.json = index; <session-id>.jsonl = full transcript.
• Memory: <workspace>/memory/
  • Daily file: memory/YYYY-MM-DD.md. Create or append a ## Session summary section.

Run scripts from the workspace root (e.g. ~/.openclaw/workspace), or pass --workspace so memory/ is resolved correctly.

1. Summarize a day’s sessions → memory (session-to-memory)

Writes a session summary for the given date into memory/YYYY-MM-DD.md (creates the file or appends a section). Memory citations and RAG will then include that day’s chat.

node skills/session-memory/scripts/session-to-memory.js --date YYYY-MM-DD

Optional:

• --date YYYY-MM-DD — date to summarize (default: yesterday in local time).
• --workspace /path/to/workspace — workspace root; memory dir is <workspace>/memory (default: cwd or ~/.openclaw/workspace).
• --sessions-dir /path — override sessions dir (default: ~/.openclaw/agents/main/sessions).
• --append — append a “Session summary” section if the file exists; otherwise replace (default: append).
• --max-messages 200 — cap messages per session when building summary (default: 200).

Example:

cd ~/.openclaw/workspace
node skills/session-memory/scripts/session-to-memory.js --date 2026-02-27 --append

Then answer the user with: “已把 2026-02-27 的会话摘要写入 memory/2026-02-27.md，之后你问当天的对话我就能通过记忆检索到。”

2. Search sessions (session-search)

Searches session JSONL by keyword and optional date range, returns snippets (session id, date, role, snippet) so the agent can use them in context. Does not write to memory; use this to answer “之前我们说过 XXX 吗？” or to gather context before summarizing.

node skills/session-memory/scripts/session-search.js --query "关键词" [--since YYYY-MM-DD] [--until YYYY-MM-DD] [--limit 20]

Optional:

• --query "..." — search phrase (required).
• --since YYYY-MM-DD — only sessions that started on or after this date.
• --until YYYY-MM-DD — only sessions that started on or before this date.
• --limit N — max number of snippets (default: 20).
• --sessions-dir /path — override sessions dir.

Output: JSON array of { sessionId, date, role, snippet, timestamp } to stdout. Use the result in your reply or to decide whether to run session-to-memory for that day.

Example:

node skills/session-memory/scripts/session-search.js --query "discord 断联" --since 2026-02-26 --limit 10

3. List sessions by date (for discovery)

To see which days have sessions (e.g. before summarizing or searching):

for f in ~/.openclaw/agents/main/sessions/*.jsonl; do
  [ -f "$f" ] && echo "$(head -1 "$f" | jq -r '.timestamp' | cut -dT -f1) $(basename "$f" .jsonl)"
done | sort -r

If jq is not available, use the session-search script with a very broad query and --limit 1 per day, or run the summarize script with --date for a specific date (it will report “no sessions” if none).

Tips

• Summarize after the day ends (or when the user asks) so memory/YYYY-MM-DD.md contains that day’s session summary; then OpenClaw’s memory/citation search will find it.
• Session search is read-only over JSONL; it does not change memory. Use it to answer “有没有说过 XXX” or to prepare a summary.
• Large sessions are truncated by --max-messages when summarizing to avoid huge memory files.