session-memory

# 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.

```bash
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:

```bash
cd ~/.openclaw/workspace
node skills/session-memory...

# session-memory

OpenClaw skill: write session summaries into daily memory files and search session history so the agent can recall and cite past conversations.

## Features

- **Session → memory**: Run `session-to-memory.js` for a date to generate or update `memory/YYYY-MM-DD.md` with a "Session summary" section. OpenClaw’s memory/citation search will then include that day’s chat.
- **Session search**: Run `session-search.js` with a query (and optional date range) to get JSON snippets from past sessions. Use this to answer “what did we say about X?” or to prepare context.

## Requirements

- Node.js (no extra npm deps)
- Sessions at `~/.openclaw/agents/main/sessions/` (default agent)
- Workspace with `memory/` directory (e.g. `~/.openclaw/workspace/memory/`)

## Usage (agent)

From the workspace root:

```bash
# Summarize 2026-02-27 into memory/2026-02-27.md
node skills/session-memory/scripts/session-to-memory.js --date 2026-02-27 --append

# Search sessions for "discord"
node skills/session-memory/scripts/session-search.js --query "discord" --since 2026-02-26 --limit 10
```

See `SKILL.md` for full usage and when the agent should use this skill.

## Version

1.0.0