session-memory

Maintains persistent per-session memory for webchat projects via CONTEXT.md and MEMORY.md files.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/mlamla123/openclaw-starter-kit --skill session-memory-mlamla123
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: session-memory
Source: https://github.com/mlamla123/openclaw-starter-kit/tree/main/skills/session-memory
Command: npx skills add https://github.com/mlamla123/openclaw-starter-kit --skill session-memory-mlamla123

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Persistent memory across days and restarts to maintain continuity between sessions.

Core Features & Use Cases

  • Per-session memory directories with CONTEXT.md, MEMORY.md, daily logs, and retros; cross-session continuity; auto-wake on idle; checkpoint cron; post-compaction recovery.
  • Chat-DB integration for message persistence; robust for gateway restart resilience.
  • Protocols for agents to read/write memory and manage compaction with safety.

Quick Start

Run the session memory setup script to initialize memory folders, start chat-db, and deploy memory-enabled gateway.

Frequently Asked Questions about session-memory

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I keep webchat sessions remembered across gateway restarts?

Persistent webchat session memory is maintained across gateway restarts using deterministic file-based state management. It keeps CONTEXT.md and MEMORY.md in sync while preserving per-session continuity through compaction and system restarts.

What is the best way to maintain long-running chat context across multiple sessions?

Maintaining long-running chat context across sessions requires per-session memory directories containing CONTEXT.md, MEMORY.md, and daily logs. This approach ensures cross-session continuity and auto-wakes idle sessions to restore full conversational context.

How do I set up chat-db integration for message persistence in webchat projects?

Setting up chat-db integration for message persistence involves running a session memory setup script that initializes memory folders, starts chat-db, and deploys a memory-enabled gateway. This configuration provides robust message persistence and gateway restart resilience.

Does webchat session memory support post-compaction recovery workflows?

Yes, webchat session memory supports post-compaction recovery workflows through a dedicated checkpoint and recovery mechanism. It keeps CONTEXT.md and MEMORY.md synchronized, preventing context loss after compaction events.

Can I use file-based state management for multi-session webchat workflows?

Yes, deterministic file-based state management works for multi-session webchat workflows. It handles per-session memory directories and checkpoint cron jobs, making it suitable for memory-dependent assistants requiring long-running continuity.

Why does my chatbot lose context after session compaction or restart?

Chatbots lose context after compaction or restart when lacking a checkpoint and recovery workflow. Implementing protocols to read and write memory files ensures agents can manage compaction safely and restore previous session state.