# Send Session Memory (Workspace) to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "session-memory-workspace",
    "name": "Session Memory (Workspace)",
    "source": "tencent",
    "type": "skill",
    "category": "效率提升",
    "sourceUrl": "https://clawhub.ai/breezezephyr/session-memory-workspace",
    "canonicalUrl": "https://clawhub.ai/breezezephyr/session-memory-workspace",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/session-memory-workspace",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=session-memory-workspace",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "PUBLISH.md",
      "README.md",
      "SKILL.md",
      "_meta.json",
      "scripts/session-search.js",
      "scripts/session-to-memory.js"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "session-memory-workspace",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-01T04:11:11.283Z",
      "expiresAt": "2026-05-08T04:11:11.283Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=session-memory-workspace",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=session-memory-workspace",
        "contentDisposition": "attachment; filename=\"session-memory-workspace-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "session-memory-workspace"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/session-memory-workspace"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/session-memory-workspace",
    "downloadUrl": "https://openagent3.xyz/downloads/session-memory-workspace",
    "agentUrl": "https://openagent3.xyz/skills/session-memory-workspace/agent",
    "manifestUrl": "https://openagent3.xyz/skills/session-memory-workspace/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/session-memory-workspace/agent.md"
  }
}
```
## Documentation

### 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.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: breezezephyr
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-01T04:11:11.283Z
- Expires at: 2026-05-08T04:11:11.283Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/session-memory-workspace)
- [Send to Agent page](https://openagent3.xyz/skills/session-memory-workspace/agent)
- [JSON manifest](https://openagent3.xyz/skills/session-memory-workspace/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/session-memory-workspace/agent.md)
- [Download page](https://openagent3.xyz/downloads/session-memory-workspace)